메인 콘텐츠로 건너뛰기
POST
cURL
POST /runwayml/v1/voice_dubbing을 사용하여 음성 오디오를 다른 언어로 번역합니다. 모델 ID는 eleven_voice_dubbing입니다. Bearer 인증과 JSON 요청 본문으로 CometAPI API 키를 전송합니다.

오디오 및 대상 언어 제공

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.

마지막 수정일 2026년 9월 21일