Image ke Video

Gunakan CometAPI untuk memanggil Runway image_to_video dan mengonversi URL gambar diam menjadi output video mentah, dengan dukungan X-Runway-Version untuk kompatibilitas.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Gunakan endpoint ini untuk menganimasikan satu gambar sumber menjadi video Runway.

​

Sebelum Anda memanggilnya

• Kirim header X-Runway-Version yang wajib, misalnya 2024-11-06
• Gunakan model: gen3a_turbo
• Sediakan promptImage HTTPS yang stabil
• Mulailah dengan duration: 5 dan rasio umum seperti 1280:720

​

Alur tugas

1. Kirim permintaan image-to-video

   Buat task dengan gambar sumber dan prompt gerakan singkat opsional.

2. Simpan id yang dikembalikan

   Simpan task id untuk polling nanti.

3. Poll status task

   Gunakan Get Task Details. Jika poll pertama mengembalikan task_not_exist, tunggu beberapa detik lalu coba lagi.

Validasi langsung pada 2026-03-13 mengonfirmasi bahwa permintaan gen3a_turbo minimal diterima dan mengembalikan sebuah id. Setelah jeda singkat, task-details resmi maupun feed reverse sama-sama mengembalikan status queued terbungkus yang sama untuk task tersebut.

Otorisasi

Authorization · string · header · wajib

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version · string · wajib

Runway version header, for example 2024-11-06.

Body

application/json

promptImage · string · default: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · wajib

Source image URL.

model · string · default: gen3a_turbo · wajib

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

Random seed for reproducible results. Range: 0–999999999.

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · default: false

Whether to add a watermark to the output video.

duration · integer · default: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · default: 1280:720

Aspect ratio of the output video.

Opsi yang tersedia: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Respons

200 - application/json

Task accepted.

id · string · wajib