Skip to main content
POST
cURL
Використовуйте POST /runwayml/v1/voice_dubbing для перекладу усного аудіо іншою мовою. Використовуйте ID моделі eleven_voice_dubbing. Надсилайте свій ключ API CometAPI за допомогою Bearer-автентифікації та тіла JSON-запиту.

Укажіть аудіо та цільову мову

Установіть для audioUri доступну HTTPS URL-адресу вихідного аудіо. Установіть для targetLang код цільової мови, наприклад es для іспанської або fr для французької. Виберіть підтримуваний код зі схеми запиту. Запит потребує model, audioUri і targetLang. Замініть приклад URL-адреси аудіо своїм вихідним файлом.

Налаштуйте дублювання

Не вказуйте булеві елементи керування, щоб використовувати значення моделі за замовчуванням. Надсилання false також використовує значення за замовчуванням.

Отримайте результат

Збережіть повернений id, а потім використайте Отримати завдання Runway щоб отримати стан завдання. Коли status має значення SUCCEEDED, перегляньте URL-адреси аудіо в output. Якщо завдання завершиться помилкою, перевірте failure і failureCode.

Авторизації

Authorization
string
header
обов'язково

Use your CometAPI API key.

Тіло

application/json

Request settings for eleven_voice_dubbing.

model
enum<string>
обов'язково

Model ID for this request.

Доступні опції:
eleven_voice_dubbing
Allowed value: "eleven_voice_dubbing"
audioUri
обов'язково

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

Required string length: 13 - 2048
Pattern: ^https:\/\/.*
targetLang
enum<string>
обов'язково

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

Доступні опції:
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.

Необхідний діапазон: x <= 9007199254740991

Відповідь

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

id
string
обов'язково

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.

Останнє оновлення 18 вересня 2026 р.