Створення завдання Runway для перетворення зображення на відео

POST

runwayml

image_to_video

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

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

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

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

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

Виберіть модель

Модель	Обов’язкові поля	Prompt руху
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	Опишіть рух у `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	За потреби опишіть рух у `promptText`, використовуючи від 1 до 1 000 кодових одиниць UTF-16.

Для запиту лише з текстом використовуйте Створення завдання Runway для перетворення тексту на відео.

Укажіть перший кадр

Установіть promptImage на доступну URL-адресу HTTPS зображення або URI даних зображення Base64. Також можна передати масив з одним елементом, що містить uri і position: "first". Цей інтерфейс приймає один початковий кадр; не додавайте запис останнього кадру. Зображення HTTPS мають бути безпосередньо доступними без перенаправлень і мати коректні заголовки вмісту зображення. URI даних закодованого зображення можуть мати розмір до 5 МБ. Див. вимоги Runway щодо медіавхідних даних щодо форматів і розмірів зображень.

Установіть тривалість і розміри

Використовуйте ціле значення duration від 2 до 10 секунд. Воно обов’язкове для gen4.5 і необов’язкове для gen4_turbo. Установіть ratio на 1280:720, 720:1280, 1104:832, 960:960, 832:1104 або 1584:672. Це значення ширини й висоти, розділені двокрапкою. Щоб явно вказати seed для семплювання, використовуйте значення від 1 до 4294967295. Якщо не вказати або вказати 0, буде вибрано випадковий seed. Якщо ви додаєте contentModeration, установіть його publicFigureThreshold значення auto або low; інакше не додавайте об’єкт.

Виберіть формат виводу

gen4.5 приймає outputFormat для MP4, ProRes, послідовностей PNG і HDR форматів, перелічених у схемі запиту. Не вказуйте поле для H.264 MP4. proresProfile застосовується лише до prores і hdr_prores; його допустимі значення залежать від вибраного формату. Не вказуйте обидва поля з gen4_turbo.

Отримайте результат

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

Авторизації

Authorization

string

header

обов'язково

Use your CometAPI API key.

Тіло

application/json

gen4.5
gen4_turbo

Request parameters for gen4.5.

model

enum<string>

обов'язково

Model ID for this request variant.

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

gen4.5

Allowed value: "gen4.5"

promptText

string

обов'язково

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

Required string length: 1 - 1000

promptImage

обов'язково

Image to use as the first frame. Supply a media URI or a one-item array with position set to first.

Maximum string length: 2048

Pattern: ^https://

ratio

enum<string>

обов'язково

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

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

1280:720,

720:1280,

1104:832,

960:960,

832:1104,

1584:672

duration

integer

обов'язково

Requested video duration in whole seconds, from 2 through 10.

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

seed

integer

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

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

contentModeration

object

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

Show child attributes

outputFormat

enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

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

mp4,

prores,

png_sequence,

hdr10,

hlg,

sdr_rec709_10bit,

hdr_pq_12bit_master,

hdr_prores,

hdr_png_sequence,

hdr_exr_sequence,

hdr_exr_acescg_sequence_1_3,

hdr_exr_acescg_sequence_2_0

proresProfile

enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

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

422,

4444,

422 Proxy,

422 LT,

422 HQ,

4444 XQ

Відповідь

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/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

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

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

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

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

API-ключі

Створення завдання Runway для перетворення зображення на відео

Виберіть модель

Укажіть перший кадр

Установіть тривалість і розміри

Виберіть формат виводу

Отримайте результат

Авторизації

Тіло

Відповідь

​Виберіть модель

​Укажіть перший кадр

​Установіть тривалість і розміри

​Виберіть формат виводу

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

Авторизації

Тіло

Відповідь

Виберіть модель

Укажіть перший кадр

Установіть тривалість і розміри

Виберіть формат виводу

Отримайте результат