Skip to main content
POST
cURL
Use POST /runwayml/v1/voice_dubbing to translate spoken audio into another language. Use the model ID eleven_voice_dubbing. Send your CometAPI API key with Bearer authentication and a JSON request body.

Provide audio and a target language

Set audioUri to an accessible HTTPS URL of your source audio. Set targetLang to the destination language code, such as es for Spanish or fr for French. Select the supported code from the request schema. The request requires model, audioUri, and targetLang. Replace the example audio URL with your source file.

Configure dubbing

Omit the boolean controls to use the model defaults. Sending false also uses the defaults.

Retrieve the result

Save the returned id, then use Get a Runway task to retrieve task status. When status is SUCCEEDED, read the audio URLs in output. If the task fails, inspect failure and failureCode.

Authorizations

Authorization
string
header
required

Use your CometAPI API key.

Body

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
required

Model ID for this request.

Available options:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
required

Audio input as an accessible HTTPS URL or base64 data URI.

Required string length: 13 - 2048
Pattern: ^https:\/\/.*
targetLang
enum<string>
required

The target language code to dub the audio to (e.g., "es" for Spanish, "fr" for French).

Available options:
en,
hi,
pt,
zh,
es,
fr,
de,
ja,
ar,
ru,
ko,
id,
it,
nl,
tr,
pl,
sv,
fil,
ms,
ro,
uk,
el,
cs,
da,
fi,
bg,
hr,
sk,
ta
disableVoiceCloning
boolean

Set true to use a generic voice instead of cloning the source voice. Omit or use false for the model default.

dropBackgroundAudio
boolean

Set true to remove background audio from the dubbed output. Omit or use false for the model default.

numSpeakers
integer

Number of speakers in the source audio. Supply a positive integer or omit it for automatic detection.

Required range: x <= 9007199254740991

Response

Task created. Save the returned id to retrieve task status.

id
string
required

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.

Last modified on September 21, 2026