Runwayのvideo-to-videoタスクを作成する
CometAPIを通じてRunway Aleph 2で動画を編集します。テキストプロンプト、時間指定のガイダンス画像、任意のターゲットアスペクト比を使用します。
aleph2 を使用して、テキストプロンプトでソース動画を編集します。リクエストでは
タスク id が返されます。完了した出力を取得するには、タスクの詳細を取得してください。
リクエストを準備する
- CometAPI APIキーで認証します。
modelをaleph2に設定し、最大30秒の動画にはvideoUriを指定します。- 任意: 編集内容を説明する
promptTextを含めます。長さは1~1,000 文字です。キーフレームを使用する場合は省略することもできます。 - 例のメディアURLをアクセス可能なHTTPS URLに置き換えてください。メディアフィールドでは エンコード後のサイズが最大5 MBのBase64データURIも使用できます。
時間指定のガイダンス画像を追加する
特定の時点をガイドするには、keyframes に1~5個のオブジェクトを指定します。
各オブジェクトには画像の uri と、次の位置指定のいずれか1つだけが含まれます。
range を使用する場合は、
すべてのキーフレームに設定してください。それ以外の場合は、すべてのキーフレームで range を省略してください。
ガイダンス画像が不要な場合は keyframes を省略してください。空の配列または
null は省略として扱われます。
フレームの形状と形式を選択する
targetAspectRatio を使用して、16:9、4:3、3:2、1:1
2:3, 3:4, 9:16、または 21:9 への拡張をリクエストできます。入力動画とガイダンス画像は
生成前にこの形状にレターボックス化されます。非推奨の ratio フィールドは
任意です。アスペクト比を制御するには targetAspectRatio を使用してください。
outputFormat が prores の場合、proresProfile を 422、4444
422 Proxy, 422 LT, 422 HQ、または 4444 XQ に設定できます。デフォルトのプロファイルは 4444 です。
4444 および 4444 XQ のアルファチャネルは不透明です。proresProfile は
他の出力形式では省略してください。
明示的にサンプリングシードを指定するには、1 から 4294967295 を使用します。seed は
ランダムなシードには省略してください。0 は省略として扱われます。
結果を取得する
返されたid を保存し、
Runwayタスクを取得 を使用してタスクのステータスを取得します。
status が SUCCEEDED の場合、結果のURLを output から読み取ります。タスクが
失敗した場合は、存在すれば failure と failureCode を確認してください。承認
Your CometAPI API key.
ボディ
Aleph 2 video-editing request.
Model ID for this request.
aleph2 Input video to edit, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.
13 - 2048^https://Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.
1 - 1000One to five timed guidance images. Each image uses exactly one of seconds or at. Omit when no guidance images are needed; an empty array or null is treated as omission.
5Guidance image positioned using seconds.
- Option 1
- Option 2
Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9 Deprecated aspect-ratio field. Use targetAspectRatio instead.
Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Output format: mp4 for H.264 MP4, prores for ProRes MOV, png_sequence for a ZIP of PNG frames, or sdr_rec709_10bit for 10-bit Rec.709 HEVC MP4. Omit for mp4.
mp4, prores, png_sequence, sdr_rec709_10bit ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.
422, 4444, 422 Proxy, 422 LT, 422 HQ, 4444 XQ Content moderation settings. Omit to use the standard settings.
レスポンス
The task was created. Save its id for task retrieval.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Task cost metadata, when returned.