Bir Runway image-to-video görevi oluşturun

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

Bir kaynak görüntüyü canlandırmak için bu endpoint’i kullanın. CometAPI API anahtarınızı şu yöntemle gönderin: Bearer kimlik doğrulaması ve bir JSON istek gövdesi.

Bir model seçin

Model	Zorunlu alanlar	Hareket Prompt’u
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	Hareketi şurada açıklayın: `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	İsteğe bağlı olarak, hareketi `promptText` içinde 1 ila 1.000 UTF-16 kod birimi kullanarak açıklayın.

Yalnızca metin içeren bir istek için şunu kullanın: Bir Runway text-to-video görevi oluşturun.

İlk kareyi sağlayın

promptImage değerini erişilebilir bir HTTPS görüntü URL’sine veya Base64 görüntü veri URI’sine ayarlayın. uri ve position: "first" içeren tek öğeli bir dizi de sağlayabilirsiniz. Bu arayüz bir başlangıç karesini kabul eder; son kare girişi eklemeyin. HTTPS görüntüler yönlendirme olmadan doğrudan erişilebilir olmalı ve geçerli görüntü içeriği başlıklarına sahip olmalıdır. Kodlanmış görüntü veri URI’leri 5 MB’a kadar olabilir. Şuraya bakın: Runway medya girdi gereksinimleri görüntü biçimleri ve boyutları için.

Süreyi ve boyutları ayarlayın

duration için 2 ila 10 saniye arasında bir tam sayı kullanın. Bu değer zorunludur gen4.5 için ve gen4_turbo için isteğe bağlıdır. ratio değerini 1280:720, 720:1280, 1104:832, 960:960, 832:1104 veya 1584:672. olarak ayarlayın. Bunlar iki nokta üst üste ile ayrılmış genişlik ve yükseklik değerleridir. Açık bir örnekleme seed’i için 1 ila 4294967295 kullanın. Atlanması veya 0 rastgele bir seed seçer. contentModeration eklerseniz, bunun publicFigureThreshold değerini auto veya low olarak ayarlayın; aksi takdirde nesneyi atlayın.

Bir çıktı biçimi seçin

gen4.5 MP4, ProRes, PNG dizileri ve HDR için outputFormat değerini kabul eder biçimleri istek şemasında listelenmiştir. H.264 MP4 için alanı atlayın. proresProfile yalnızca prores ve hdr_prores için geçerlidir; izin verilen değerleri seçilen biçime bağlıdır. gen4_turbo ile her iki alanı da atlayın.

Sonucu alın

Döndürülen id değerini kaydedin ve şunu kullanın: Bir Runway görevi alın. status değeri SUCCEEDED olduğunda, sonuç URL’lerini output içinde okuyun.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key.

Gövde

application/json

gen4.5
gen4_turbo

Request parameters for gen4.5.

model

enum<string>

gerekli

Model ID for this request variant.

Mevcut seçenekler:

gen4.5

Allowed value: "gen4.5"

promptText

string

gerekli

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

Required string length: 1 - 1000

promptImage

gerekli

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>

gerekli

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

Mevcut seçenekler:

1280:720,

720:1280,

1104:832,

960:960,

832:1104,

1584:672

duration

integer

gerekli

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

Gerekli aralık: 2 <= x <= 10

seed

integer

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

Gerekli aralık: 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.

Mevcut seçenekler:

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.

Mevcut seçenekler:

422,

4444,

422 Proxy,

422 LT,

422 HQ,

4444 XQ

Yanıt

Task submitted. Save its id to retrieve task status.

string

gerekli

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

Son değiştirilme tarihi 18 Eylül 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>"
  }
}

İçerik moderasyonu

API anahtarları

Bir Runway image-to-video görevi oluşturun

Bir model seçin

İlk kareyi sağlayın

Süreyi ve boyutları ayarlayın

Bir çıktı biçimi seçin

Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

​Bir model seçin

​İlk kareyi sağlayın

​Süreyi ve boyutları ayarlayın

​Bir çıktı biçimi seçin

​Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

Bir model seçin

İlk kareyi sağlayın

Süreyi ve boyutları ayarlayın

Bir çıktı biçimi seçin

Sonucu alın