Створення зображення Runway

POST

runwayml

text_to_image

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Використовуйте цей endpoint, щоб генерувати зображення з Prompt, з необов’язковими еталонними зображеннями для gen4_image. Надсилайте свій ключ API CometAPI з автентифікацією Bearer і тіло JSON-запиту.

Вибір моделі та еталонних зображень

Кожен запит потребує model, promptText і ratio.

Модель	`referenceImages`
`gen4_image`	Необов’язково. Не вказуйте його або використовуйте `[]` для генерації лише за текстом чи надайте до трьох зображень.
`gen4_image_turbo`	Надайте від одного до трьох зображень.

Для gen4_image_turbo параметр referenceImages є обов’язковим і має містити від одного до трьох зображень. Кожен об’єкт еталонного зображення містить URI зображення uri і необов’язковий tag. Використовуйте тег із 3–16 малих літер, цифр або символів підкреслення, який починається з літери. Посилайтеся на нього в promptText як @tag, наприклад @cat_ref. URI зображень приймають доступні HTTPS URL-адреси або URI даних зображень Base64 розміром до 5 МБ. Prompt приймає від 1 до 1000 кодових одиниць UTF-16.

Вибір розмірів

Установіть для ratio одну з точних пар розмірів у схемі. Наприклад, 1024:1024 запитує квадратне зображення, 1280:720 — пейзажне зображення, а 720:1280 — портретне зображення. Використовуйте ratio для вибору розмірів; не надсилайте resolution або size із цими моделями. Для явного seed вибірки використовуйте 1 до 4294967295. Відсутність або 0 вибирає випадковий seed. Якщо ви додаєте contentModeration, установіть його publicFigureThreshold значенням auto або low; інакше не вказуйте об’єкт.

Отримання результату

Збережіть отриманий id і скористайтеся Отримання завдання Runway. Коли status має значення SUCCEEDED, перегляньте URL-адреси згенерованих зображень у output.

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key.

Тіло

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

обов'язково

Model ID for this request variant.

Доступні опції:

gen4_image

Allowed value: "gen4_image"

promptText

string

обов'язково

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000

ratio

enum<string>

обов'язково

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Доступні опції:

1024:1024,

1080:1080,

1168:880,

1360:768,

1440:1080,

1080:1440,

1808:768,

1920:1080,

1080:1920,

2112:912,

1280:720,

720:1280,

720:720,

960:720,

720:960,

1680:720

seed

integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Необхідний діапазон: 0 <= x <= 4294967295

referenceImages

object[]

Optional array of up to three reference images. Omit it or use an empty array for text-only generation.

Maximum array length: 3

Show child attributes

contentModeration

object

Optional content moderation settings. Omit the object to use standard moderation.

Show child attributes

Відповідь

Task submitted. Save its id to retrieve task status.

string

обов'язково

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Останнє оновлення 18 вересня 2026 р.

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Модерація контенту

API-ключі

Створення зображення Runway

Вибір моделі та еталонних зображень

Вибір розмірів

Отримання результату

Авторизації

Тіло

Відповідь

​Вибір моделі та еталонних зображень

​Вибір розмірів

​Отримання результату

Авторизації

Тіло

Відповідь

Вибір моделі та еталонних зображень

Вибір розмірів

Отримання результату