Görüntüden Videoya

Runway image_to_video çağrısı yapmak ve durağan bir görüntü URL’sini ham video çıktısına dönüştürmek için CometAPI kullanın; uyumluluk için X-Runway-Version desteği sunar.

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"
}

Bu endpoint’i, tek bir kaynak görüntüyü bir Runway videosuna canlandırmak için kullanın.

​

Çağırmadan önce

• Gerekli X-Runway-Version header’ını gönderin, örneğin 2024-11-06
• model: gen3a_turbo kullanın
• Kararlı bir HTTPS promptImage sağlayın
• duration: 5 ve 1280:720 gibi yaygın bir oranla başlayın

​

Görev akışı

1. Görüntüden videoya isteğini gönderin

   Kaynak bir görüntü ve isteğe bağlı kısa bir hareket prompt’u ile görevi oluşturun.

2. Dönen id değerini saklayın

   Görev id değerini daha sonra polling yapmak için kaydedin.

3. Görev durumunu sorgulayın

   Get Task Details kullanın. İlk sorgu task_not_exist döndürürse birkaç saniye bekleyin ve yeniden deneyin.

2026-03-13 tarihinde yapılan canlı doğrulama, minimum düzeyde bir gen3a_turbo isteğinin kabul edildiğini ve bir id döndürdüğünü doğruladı. Kısa bir gecikmenin ardından hem resmi görev ayrıntıları hem de ters feed, bu görev için aynı sarmalanmış queued durumunu döndürdü.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

X-Runway-Version · string · gerekli

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

Gövde

application/json

promptImage · string · varsayılan: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · gerekli

Source image URL.

model · string · varsayılan: gen3a_turbo · gerekli

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 · varsayılan: false

Whether to add a watermark to the output video.

duration · integer · varsayılan: 5

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

ratio · enum<string> · varsayılan: 1280:720

Aspect ratio of the output video.

Mevcut seçenekler: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Yanıt

200 - application/json

Task accepted.

id · string · gerekli