Start generating

Voice dubbing

This endpoint will start a new task to dub audio content to a target language.

post/v1/voice_dubbing

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

targetLang'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' required

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

disableVoiceCloningboolean

Whether to disable voice cloning and use a generic voice instead.

dropBackgroundAudioboolean

Whether to remove background audio from the dubbed output.

numSpeakersinteger

The number of speakers in the audio. If not provided, it will be detected automatically.

model'eleven_voice_dubbing' required

Example request

{
  "audioUri": "https://example.com/audio.mp3"
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.

Changes

Changed in 7 of the 54 revisions of this API.2616

Aug 7, 202673a12c23285c2See the full diff
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the required property estimatedCost to the response with the 200 status
  response-required-property-added
Dec 4, 20256dab1bdab5d33See the full diff
- ○
  the model request property default value eleven_voice_dubbing was removed
  request-property-default-value-removed
- ○
  the oneOf[subschema #1: eleven_voice_dubbing]/numSpeakers request property's exclusiveMinimum was decreased from true to 0.00
  request-property-exclusive-min-decreased
- ○
  added the media type application/json for the response with the status 429
  response-media-type-added
Dec 3, 2025c2a88516fa0c2See the full diff
- ○
  the model request property default value eleven_voice_dubbing was added
  request-property-default-value-added
- ○
  the oneOf[subschema #1: eleven_voice_dubbing]/numSpeakers request property's exclusiveMinimum was decreased from 0.00 to true
  request-property-exclusive-min-decreased
Dec 3, 202576b3962cf49e2See the full diff
- ○
  the model request property default value eleven_voice_dubbing was removed
  request-property-default-value-removed
- ○
  the oneOf[subschema #1: eleven_voice_dubbing]/numSpeakers request property's exclusiveMinimum was decreased from true to 0.00
  request-property-exclusive-min-decreased
Nov 4, 20256902fa9494c512See the full diff
- ▲
  removed subschema #1 subschema #2 from the oneOf[subschema #1: eleven_voice_dubbing]/audioUri request property anyOf list
  request-property-any-of-removed
- ○
  added subschema #1 subschema #2 subschema #3 to the oneOf[subschema #1: eleven_voice_dubbing]/audioUri request property anyOf list
  request-property-any-of-added
- ○
  the model request property default value eleven_voice_dubbing was added
  request-property-default-value-added
Oct 22, 202590724848e40f164See the full diff
- ▲
  the request's body type/format changed from object/ to /
  request-body-type-changed
- ●
  removed the request property audioUri
  request-property-removed
- ●
  removed the request property disableVoiceCloning
  request-property-removed
- ●
  removed the request property dropBackgroundAudio
  request-property-removed
- ●
  removed the request property model
  request-property-removed
- ●
  removed the request property numSpeakers
  request-property-removed
- ●
  removed the request property targetLang
  request-property-removed
- ○
  added request discriminator
  request-body-discriminator-added
- ○
  added subschema #1: eleven_voice_dubbing to the request body oneOf list
  request-body-one-of-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  the id response's property pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ was added for the status 200
  response-property-pattern-added
Oct 14, 202562779ce32ca81See the full diff
- ○
  endpoint added
  endpoint-added

Full history