Runway キャラクターパフォーマンスを作成する
キャラクター画像または動画と参照パフォーマンスクリップを使用して、CometAPI 経由で Runway Act-Two キャラクターパフォーマンスタスクを作成します。
act_two を使用して、キャラクター画像
または動画に参照動画のパフォーマンスを適用します。リクエストにより、完成した出力を取得するためのタスク id が返されます。
アセットを準備する
- CometAPI API キーで認証します。
modelをact_twoに設定します。character.typeをimageまたはvideoとして指定し、アセットにはcharacter.uriを使用してください。認識可能な顔が表示され、フレーム内に収まるようにしてください。reference.typeをvideoとして指定し、3~30 秒のパフォーマンスクリップにはreference.uriを使用してください。- 例のメディア URL をアクセス可能な HTTPS URL に置き換えてください。メディアフィールドでは エンコード後のサイズが最大 5 MB の Base64 データ URI も受け付けます。
パフォーマンスを設定する
必須なのはmodel、character、および reference のみです。
bodyControl: false は省略として扱われるため、明示的に
ボディコントロールを無効にしません。seed または expressionIntensity が 0 の場合も
省略として扱われます。オプションフィールドは null を送信するのではなく、省略してください。
任意の ratio の値として使用できるのは 1280:720
720:1280, 960:960, 1104:832, 832:1104、または 1584:672 です。
結果を取得する
返されたid を保存し、
Runway タスクを取得する を使用してタスクのステータスを取得します。
status が SUCCEEDED の場合、結果 URL は output から読み取ります。タスクが
失敗した場合は、存在する場合に failure と failureCode を確認してください。承認
Your CometAPI API key.
ボディ
Act-Two character-performance request.
Model ID for this request.
act_two Character image or video to animate. Keep a recognizable face visible and inside the frame.
- Option 1
- Option 2
Reference video containing the performance to apply. The video must be 3 to 30 seconds long.
Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.
Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.
0 <= x <= 5Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Optional requested frame dimensions.
1280:720, 720:1280, 960:960, 1104:832, 832:1104, 1584:672 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.