Skip to main content
POST
cURL
このエンドポイントを使用すると、1 枚の元画像をアニメーション化して Runway の動画を生成できます。

呼び出す前に

  • 必須の X-Runway-Version ヘッダーを送信します。例: 2024-11-06
  • model: gen3a_turbo を使用します
  • 安定した HTTPS の promptImage を指定します
  • duration: 5 と、選択した Runway の model/version でサポートされる ratio 値から始めます

duration と ratio

Runway の公式フォーマットのリクエストでは、size ではなく ratio を使用します。解像度スタイルの ratio 値は、その WxH 相当として読み取ってください: 1280:7201280x720720:1280720x1280 を対象とし、1280:768 も選択した model/version によっては 1280x720 としてレンダリングされる場合があります。

タスクの流れ

1

image-to-video リクエストを送信する

元画像と、必要に応じて短いモーションプロンプトでタスクを作成します。
2

返された id を保存する

後でポーリングできるように、タスクの id を保存します。
3

タスクのステータスをポーリングする

Runway タスクを取得する を使用します。最初のポーリングで task_not_exist が返された場合は、数秒待ってから再試行してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

X-Runway-Version
string
必須

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

ボディ

application/json
promptImage
string
デフォルト:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
必須

Source image URL.

model
string
デフォルト:gen3a_turbo
必須

Runway image-to-video model ID. Choose an available 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
デフォルト:false

Whether to add a watermark to the output video.

duration
integer
デフォルト:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
デフォルト:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

レスポンス

200 - application/json

Task accepted.

id
string
必須