Skip to main content
POST
cURL
Usa POST /runwayml/v1/voice_dubbing para traducir audio hablado a otro idioma. Usa el ID de modelo eleven_voice_dubbing. Envía tu clave de API de CometAPI con autenticación Bearer y un cuerpo de solicitud JSON.

Proporciona audio y un idioma de destino

Establece audioUri en una URL HTTPS accesible de tu audio de origen. Establece targetLang en el código de idioma de destino, como es para español o fr para francés. Selecciona el código compatible en el esquema de solicitud. La solicitud requiere model, audioUri y targetLang. Sustituye la URL de audio de ejemplo por tu archivo de origen.

Configura el doblaje

Omite los controles booleanos para usar los valores predeterminados del modelo. Enviar false también usa los valores predeterminados.

Recupera el resultado

Guarda el id devuelto y luego usa Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status es SUCCEEDED, lee las URL de audio en output. Si la tarea falla, inspecciona failure y failureCode.

Autorizaciones

Authorization
string
header
requerido

Use your CometAPI API key.

Cuerpo

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
requerido

Model ID for this request.

Opciones disponibles:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
requerido

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

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

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

Opciones 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.

Rango requerido: x <= 9007199254740991

Respuesta

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

id
string
requerido

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.

Última modificación el 18 de septiembre de 2026