Skip to main content
POST
cURL
Usa POST /runwayml/v1/voice_dubbing per tradurre l’audio parlato in un’altra lingua. Usa l’ID modello eleven_voice_dubbing. Invia la chiave API CometAPI con l’autenticazione Bearer e un corpo della richiesta JSON.

Fornisci l’audio e una lingua di destinazione

Imposta audioUri su un URL HTTPS accessibile dell’audio di origine. Imposta targetLang sul codice della lingua di destinazione, ad esempio es per lo spagnolo o fr per il francese. Seleziona il codice supportato dallo schema della richiesta. La richiesta richiede model, audioUri e targetLang. Sostituisci l’URL audio di esempio con il file di origine.

Configura il doppiaggio

Ometti i controlli booleani per usare i valori predefiniti del modello. L’invio di false usa anch’esso i valori predefiniti.

Recupera il risultato

Salva il valore id restituito, quindi usa Ottieni un’attività Runway per recuperare lo stato dell’attività. Quando status è SUCCEEDED, leggi gli URL audio in output. Se l’attività non riesce, esamina failure e failureCode.

Autorizzazioni

Authorization
string
header
obbligatorio

Use your CometAPI API key.

Corpo

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
obbligatorio

Model ID for this request.

Opzioni disponibili:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
obbligatorio

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

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

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

Opzioni disponibili:
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.

Intervallo richiesto: x <= 9007199254740991

Risposta

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

id
string
obbligatorio

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.

Ultima modifica il 18 settembre 2026