Animate a character (Act-Two)
runway_act_twoAnimate a character with Runway Act-Two: a driving performance video (3-30 s) moves a character given as an image or video asset, with optional body control and expression intensity. For motion transfer with Kling use runway_create_video (model kling-3.0-motion-control); to change only the voice of a video use runway_act_two_voice. Waits up to ~50 s, then returns the video url and assetId, the failure reason or the taskId for runway_get_task. Uses credits, or none with exploreMode. POST /gen4/act-two.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"driving_assetId": "<driving_assetId>",
"character_assetId": "<character_assetId>"
},
"name": "runway_act_two"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for reproducible results, 1-2147483647; random when omitted. | |
| wait | No | Wait up to ~50 s for the task to finish (default true); false returns the taskId at once. | |
| replyRef | No | Your own reference id, stored and returned with the task. | |
| replyUrl | No | A callback URL the API calls with the task (the runway_get_task shape) when it completes or fails. Default: the replyUrl of your useapi.net account. | |
| exploreMode | No | Explore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan. Omit or false: Credits Mode. | |
| aspect_ratio | No | Output shape. Default 16:9. | |
| body_control | No | Track body movement as well as the face (default true). | |
| driving_assetId | Yes | driving_assetId, the performance video (3-30 s): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset. | |
| character_assetId | Yes | character_assetId, the character as an image or video asset: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset. | |
| expression_intensity | No | Facial expression intensity, 1-5 (default 3). |