Text-to-Video

POST /runway/pro/generate, CometAPI aracılığıyla Runway ile GEN-4 text-to-video üretir ve sürümlü çıktılar için X-Runway-Version desteği sunar.

POST /runway/pro/generate

generate(text)

cURL

curl --request POST \
  --url https://api.cometapi.com/runway/pro/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "http://baidu.com",
  "ratio": "16:9",
  "prompt": "a cat",
  "style": "cinematic",
  "model": "gen4",
  "options": {
    "seconds": 10,
    "motion_vector": {
      "x": 0,
      "y": 0.3999999999999999,
      "z": 0,
      "r": -6,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}
'

200

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}

Bu endpoint’i, Runway reverse-format GEN-4 text-to-video görevini başlatmak için kullanın.

​

CometAPI üzerinde gerekli alanlar

• callback_url şu anda wrapper tarafından zorunlu tutulur
• prompt, ratio, style ve model, üretim isteğini tanımlar
• options.seconds ve options.motion_vector, mevcut wrapper şeması tarafından zorunlu tutulur

​

Doğrulanmış istek yolu

• Header: X-Runway-Version: 2024-11-06
• Model: gen4_turbo
• Yanıt: code: 200, msg: 成功 ve data.task_id

​

Görev akışı

1. Görevi oluştur

   İsteği gönderin ve döndürülen task_id değerini saklayın.

2. Reverse-format feed rotasını sorgula

   Görev durumunu takip etmek için Feed Get Task ile devam edin.

3. Tamamlanan asset'i kalıcı olarak sakla

   Bir video URL’si kullanılabilir olduğunda, bunu kendi depolama pipeline’ınıza taşıyın.

callback_url değerini atlarsanız, mevcut CometAPI wrapper’ı bunun görev tabanlı bir async API olmasına rağmen callback_url_empty döndürür.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

X-Runway-Version · string

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

Gövde

application/json

callback_url · string · varsayılan: https://example.com/webhook · gerekli

Webhook URL that receives a POST request with the result when the task completes.

ratio · string · varsayılan: 16:9 · gerekli

Aspect ratio of the generated video, e.g. 16:9, 9:16, 1:1.

prompt · string · varsayılan: A cat sitting on a windowsill. · gerekli

Text prompt describing the video content to generate.

style · string · varsayılan: cinematic · gerekli

Artistic style for the generated video, e.g. cinematic.

model · string · varsayılan: gen4 · gerekli

Model version to use, e.g. gen4.

options · object · gerekli

Advanced generation options including duration and camera motion.

Show child attributes

Yanıt

200 - application/json

OK

code · integer · gerekli

HTTP status code or business status code

msg · string · gerekli

Text description of the status code

data · object · gerekli

Business data body containing detailed task information

Show child attributes

exec_time · number · gerekli

Execution time of the API interface itself (in seconds), does not represent the total video generation time