Runway 画像から動画へのタスクを作成

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

このエンドポイントを使用して、ソース画像をアニメーション化します。CometAPI API キーを Bearer 認証と JSON リクエスト本文で送信します。

モデルを選択する

モデル	必須フィールド	モーションプロンプト
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	モーションは `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	任意で、`promptText` にモーションを記述できます。UTF-16 コード単位で 1～1,000 個使用できます。

テキストのみのリクエストには、 Runway テキストから動画へのタスクを作成.

最初のフレームを指定する

promptImage を、アクセス可能な HTTPS 画像 URL または Base64 画像データ URI に設定します。 uri と position: "first" を含む要素が1つの配列を指定することもできます。このインターフェースは開始フレームを1つ受け付けます。最終フレームのエントリは追加しないでください。 HTTPS 画像はリダイレクトなしで直接アクセス可能であり、有効な画像コンテンツヘッダーを持つ必要があります。エンコードされた画像データ URI は最大 5 MB です。次の Runway メディア入力要件で画像形式と寸法を確認してください。

長さと寸法を設定する

整数の duration を 2～10 秒の範囲で使用します。これは必須 gen4.5 では必須で、gen4_turbo では任意です。 ratio を 1280:720、720:1280、1104:832、960:960、832:1104、または 1584:672に設定します。これらはコロン区切りの幅と高さの値です。明示的にサンプリングシードを指定するには、1～4294967295 を使用します。省略するか 0 を指定すると、ランダムなシードが選択されます。contentModeration を含める場合は、その publicFigureThreshold を auto または low に設定します。それ以外の場合はオブジェクトを省略します。

出力形式を選択する

gen4.5 では、MP4、ProRes、PNG シーケンス、および HDR 形式に outputFormat を使用できます。リクエストスキーマに記載されている形式です。H.264 MP4 の場合は、このフィールドを省略します。 proresProfile は prores と hdr_prores にのみ適用され、許可される値は選択した形式によって異なります。gen4_turbo では両方のフィールドを省略します。

結果を取得する

返された id を保存し、次を使用します Runway タスクを取得する. status が SUCCEEDED の場合、output 内の結果 URL を読み取ります。

承認

Authorization

string

header

必須

Use your CometAPI API key.

ボディ

application/json

gen4.5
gen4_turbo

Request parameters for gen4.5.

model

enum<string>

必須

Model ID for this request variant.

利用可能なオプション:

gen4.5

Allowed value: "gen4.5"

promptText

string

必須

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

Required string length: 1 - 1000

promptImage

必須

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>

必須

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

利用可能なオプション:

1280:720,

720:1280,

1104:832,

960:960,

832:1104,

1584:672

duration

integer

必須

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

必須範囲: 2 <= x <= 10

seed

integer

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

必須範囲: 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.

利用可能なオプション:

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.

利用可能なオプション:

422,

4444,

422 Proxy,

422 LT,

422 HQ,

4444 XQ

レスポンス

Task submitted. Save its id to retrieve task status.

string

必須

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

最終更新日 2026年9月18日

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

コンテンツモデレーション

APIキー

Runway 画像から動画へのタスクを作成

モデルを選択する

最初のフレームを指定する

長さと寸法を設定する

出力形式を選択する

結果を取得する

承認

ボディ

レスポンス

​モデルを選択する

​最初のフレームを指定する

​長さと寸法を設定する

​出力形式を選択する

​結果を取得する

承認

ボディ

レスポンス

モデルを選択する

最初のフレームを指定する

長さと寸法を設定する

出力形式を選択する

結果を取得する