Skip to main content
POST
cURL
Konuşulan sesi başka bir dile çevirmek için POST /runwayml/v1/voice_dubbing kullanın dil. Model ID olarak eleven_voice_dubbing kullanın. CometAPI API anahtarınızı Bearer kimlik doğrulaması ve bir JSON istek gövdesiyle gönderin.

Ses ve hedef dil sağlayın

audioUri değerini kaynak sesinizin erişilebilir HTTPS URL’si olarak ayarlayın. targetLang değerini, İspanyolca için es gibi bir hedef dil koduna ayarlayın veya Fransızca için fr kullanın. Desteklenen kodu istek şemasından seçin. İstek için model, audioUri ve targetLang gereklidir. Örnek ses URL’sini kaynak dosyanızla değiştirin.

Dublajı yapılandırın

Model varsayılanlarını kullanmak için boolean denetimlerini belirtmeyin. false gönderilmesi de varsayılan ayarları kullanır.

Sonucu alın

Döndürülen id değerini kaydedin, ardından Bir Runway görevi alma işlemini görev durumunu almak için kullanın. status değeri SUCCEEDED olduğunda, ses URL’lerini şu öğeden alın: output. Görev başarısız olursa, failure ve failureCode değerlerini inceleyin.

Yetkilendirmeler

Authorization
string
header
gerekli

Use your CometAPI API key.

Gövde

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
gerekli

Model ID for this request.

Mevcut seçenekler:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
gerekli

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

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

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

Mevcut seçenekler:
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.

Gerekli aralık: x <= 9007199254740991

Yanıt

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

id
string
gerekli

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.

Son değiştirilme tarihi 18 Eylül 2026