Skip to main content
POST
cURL
Bir metin Prompt’undan video oluşturmak için gen4.5 kullanın. CometAPI API anahtarınızı Bearer kimlik doğrulaması ve bir JSON istek gövdesiyle gönderin.

İsteği hazırlayın

  • model değerini gen4.5 olarak ayarlayın.
  • promptText içinde sahneyi ve hareketi 1 ila 1.000 UTF-16 kod birimi kullanarak açıklayın.
  • Yatay için ratio değerini 1280:720 olarak, dikey için ise 720:1280 olarak ayarlayın.
  • duration değerini 2 ile 10 saniye arasında bir tam sayı olarak ayarlayın.
Dört alanın tümü zorunludur. Bir görüntüden başlamak için şunu kullanın: Bir Runway görüntüden videoya görevi oluşturun. Bu metinden videoya isteğine promptImage veya audio geçişi eklemeyin.

İsteğe bağlı denetimleri ayarlayın

Açık bir örnekleme seed’i için 1 ile 4294967295 arasını kullanın. Atlanması veya 0 rastgele bir seed seçer. contentModeration eklerseniz, onun publicFigureThreshold değerini auto ya da low olarak ayarlayın; aksi takdirde nesneyi atlayın. MP4, ProRes, PNG dizilerini veya HDR biçimlerinden birini seçmek için outputFormat kullanın istek şemasında listelenen biçimlerden birini seçin. H.264 MP4 için bunu atlayın. Şunu ayarlayabilirsiniz: proresProfile yalnızca outputFormat değeri prores veya hdr_prores olduğunda. HDR ProRes biçimi 422, 422 HQ veya 4444 kabul eder.

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, output içindeki video URL’lerini okuyun.

Yetkilendirmeler

Authorization
string
header
gerekli

Use your CometAPI API key.

Gövde

application/json

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
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
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.

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.

id
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.

cost
object

Task cost metadata, when returned.

Son değiştirilme tarihi 18 Eylül 2026