Skip to main content
POST
cURL
このエンドポイントは、参照クリップのパフォーマンスをキャラクター画像またはキャラクター動画に転送するために使用します。

呼び出す前に

  • 必須の X-Runway-Version ヘッダーを送信します。例: 2024-11-06
  • model: act_two を使用します
  • アクセス可能な HTTPS URL として、1 つの character アセットと 1 つの reference アセットを指定します
  • スタイルを調整する前に、bodyControl: true と適度な expressionIntensity から始めます

出力比率

タスクの流れ

1

キャラクターパフォーマンスのリクエストを送信

キャラクターアセット、参照アセット、およびモーション設定を使用してタスクを作成します。
2

返された task id を保存

返された id を保持してください。後でポーリングするために必要です。
3

タスクステータスをポーリング

タスクが終了状態に達し、provider metadata に完了した出力が含まれるまで、Runway タスクを取得する に進みます。

入力の役割

  • character は、アニメーション化したい対象です
  • reference は、表情のパフォーマンスまたは身体の動きを提供する元のクリップです
  • bodyControl は、モーション転送に表情転送に加えて身体の動きも含めるかどうかを決定します
  • contentModeration は、リクエストに対してプロバイダーのモデレーションしきい値を適用します

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

X-Runway-Version
string
必須

Runway version header, for example 2024-11-06.

ボディ

application/json
character
object
必須

The character to control. You can either provide a video or an image.

reference
object
必須

Reference performance clip. Provide type (video) and uri (HTTPS URL).

bodyControl
boolean
デフォルト:true
必須

Enable body control.

expressionIntensity
integer
デフォルト:1
必須

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

seed
integer
デフォルト:1
必須

Random seed for reproducible results.

model
string
デフォルト:act_two
必須

The model variant to use. Must be act_two.

ratio
string
デフォルト:1280:720
必須

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
必須

レスポンス

200 - application/json

Task accepted.

id
string
必須