画像から動画

CometAPI を使用して Runway の image_to_video を呼び出し、静止画像URLを生の動画出力に変換します。互換性のための X-Runway-Version に対応しています。

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

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

​

呼び出す前に

• 必須の X-Runway-Version ヘッダーを送信してください。たとえば 2024-11-06 です
• model: gen3a_turbo を使用してください
• 安定してアクセス可能な HTTPS の promptImage を指定してください
• duration: 5 と、1280:720 のような一般的な比率から始めてください

​

タスクの流れ

1. 画像から動画へのリクエストを送信

   元画像と、任意の短いモーションプロンプトを指定してタスクを作成します。

2. 返された id を保存

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

3. タスクのステータスをポーリング

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

2026-03-13 の実地検証では、最小構成の gen3a_turbo リクエストが受理され、id が返されることが確認されました。短い待機時間の後、公式の task-details とリバースの feed の両方が、そのタスクに対して同じラップされた queued ステータスを返しました。

承認

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 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 · デフォルト: false

Whether to add a watermark to the output video.

duration · integer · デフォルト: 5

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

ratio · enum<string> · デフォルト: 1280:720

Aspect ratio of the output video.

利用可能なオプション: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

レスポンス

200 - application/json

Task accepted.

id · string · 必須