Skip to main content
POST
cURL
Utilisez POST /runwayml/v1/voice_dubbing pour traduire l’audio parlé dans une autre langue. Utilisez l’ID de modèle eleven_voice_dubbing. Envoyez votre clé API CometAPI avec l’authentification Bearer et un corps de requête JSON.

Fournir l’audio et une langue cible

Définissez audioUri sur une URL HTTPS accessible de votre audio source. Définissez targetLang sur le code de langue de destination, par exemple es pour l’espagnol ou fr pour le français. Sélectionnez le code pris en charge dans le schéma de requête. La requête nécessite model, audioUri et targetLang. Remplacez l’URL audio d’exemple par votre fichier source.

Configurer le doublage

Omettez les contrôles booléens pour utiliser les valeurs par défaut du modèle. L’envoi de false utilise également les valeurs par défaut.

Récupérer le résultat

Enregistrez le id renvoyé, puis utilisez Obtenir une tâche Runway pour récupérer l’état de la tâche. Lorsque status est SUCCEEDED, lisez les URL audio dans output. Si la tâche échoue, inspectez failure et failureCode.

Autorisations

Authorization
string
header
requis

Use your CometAPI API key.

Corps

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
requis

Model ID for this request.

Options disponibles:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
requis

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

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

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

Options disponibles:
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.

Plage requise: x <= 9007199254740991

Réponse

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

id
string
requis

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.

Dernière modification le 21 septembre 2026