Skip to main content
POST
cURL
act_two を使用して、キャラクター画像 または動画に参照動画のパフォーマンスを適用します。リクエストにより、完成した出力を取得するためのタスク id が返されます。

アセットを準備する

  • CometAPI API キーで認証します。
  • modelact_two に設定します。
  • character.typeimage または video として指定し、アセットには character.uriを使用してください。認識可能な顔が表示され、フレーム内に収まるようにしてください。
  • reference.typevideo として指定し、3~30 秒のパフォーマンスクリップには reference.uri を使用してください。
  • 例のメディア URL をアクセス可能な HTTPS URL に置き換えてください。メディアフィールドでは エンコード後のサイズが最大 5 MB の Base64 データ URI も受け付けます。

パフォーマンスを設定する

必須なのは modelcharacter、および reference のみです。 bodyControl: false は省略として扱われるため、明示的に ボディコントロールを無効にしません。seed または expressionIntensity0 の場合も 省略として扱われます。オプションフィールドは null を送信するのではなく、省略してください。 任意の ratio の値として使用できるのは 1280:720 720:1280, 960:960, 1104:832, 832:1104、または 1584:672 です。

結果を取得する

返された id を保存し、 Runway タスクを取得する を使用してタスクのステータスを取得します。 statusSUCCEEDED の場合、結果 URL は output から読み取ります。タスクが 失敗した場合は、存在する場合に failurefailureCode を確認してください。

承認

Authorization
string
header
必須

Your CometAPI API key.

ボディ

application/json

Act-Two character-performance request.

model
enum<string>
必須

Model ID for this request.

利用可能なオプション:
act_two
character
object
必須

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
必須

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

必須範囲: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

必須範囲: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

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

Content moderation settings. Omit to use the standard settings.

レスポンス

The task was created. Save its id for task retrieval.

id
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.

cost
object

Task cost metadata, when returned.

最終更新日 2026年9月18日