Lip sync a face
runway_lipsyncMake the face in an image or video asset speak: either an audio asset, or voice_text read by one of Runway's voices (voiceId from runway_list_lipsync_voices). Give exactly one of image_assetId / video_assetId and exactly one of audio_assetId / voiceId. To swap the voice of a whole 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 /lipsync/create.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "runway_lipsync"
}
}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. | |
| maxJobs | No | Override the account's maxJobs (Runway tasks at once) for this request, 1-10. Default: the account's own setting. | |
| voiceId | No | A Runway voice (voiceId from runway_list_lipsync_voices) that reads voice_text; instead of audio_assetId. | |
| model_id | No | The voice model, only with voiceId: eleven_multilingual_v1 (default) or eleven_multilingual_v2 (28+ languages). | |
| 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. | |
| voice_text | No | The text the voice reads; required with voiceId and only used with it. | |
| 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. | |
| audio_assetId | No | audio_assetId, the speech to sync to (or use voiceId with voice_text): 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. | |
| image_assetId | No | image_assetId, the face image (or use video_assetId): 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. | |
| video_assetId | No | video_assetId, the face video (or use image_assetId): 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. |