Skip to main content
POST
cURL
Bruk POST /runwayml/v1/voice_dubbing til å oversette talt lyd til et annet språk. Bruk modell-ID-en eleven_voice_dubbing. Send CometAPI API-nøkkelen med Bearer-autentisering og en JSON-forespørselstekst.

Oppgi lyd og et målspråk

Angi audioUri til en tilgjengelig HTTPS-URL for kildelyden din. Angi targetLang til språkkoden for målspråket, for eksempel es for spansk eller fr for fransk. Velg den støttede koden fra forespørselsskjemaet. Forespørselen krever model, audioUri og targetLang. Erstatt eksempel-URL-en for lyd med kildefilen din.

Konfigurer dubbing

Utelat de boolske kontrollene for å bruke modellstandardene. Å sende false bruker også standardene.

Hent resultatet

Lagre den returnerte id, og bruk Hent en Runway-oppgave for å hente oppgavestatus. Når status er SUCCEEDED, les lyd-URL-ene i output. Hvis oppgaven mislykkes, undersøk failure og failureCode.

Autorisasjoner

Authorization
string
header
påkrevd

Use your CometAPI API key.

Kropp

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
påkrevd

Model ID for this request.

Tilgjengelige alternativer:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
påkrevd

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

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

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

Tilgjengelige alternativer:
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.

Nødvendig område: x <= 9007199254740991

Svar

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

id
string
påkrevd

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.

Sist endret 18. september 2026