Swap the voice of a video
runway_act_two_voiceReplace the voice in a video (3-30 s) with one of Runway's voices (Act-Two voice swap), keeping the picture. Pick a voiceId with runway_list_lipsync_voices. To make a face speak new words use runway_lipsync; to animate a character use runway_act_two. 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-voice.
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": {
"video_assetId": "<video_assetId>",
"voiceId": "<voiceId>"
},
"name": "runway_act_two_voice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the task to finish (default true); false returns the taskId at once. | |
| voiceId | Yes | The voice to use: a voiceId from runway_list_lipsync_voices. | |
| 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. | |
| video_assetId | Yes | video_assetId, the video (3-30 s) whose voice to swap: 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. |