소개
audio_url과 대상 언어를 제공해 팟캐스트, 음성 메모, 내레이션, 오디오 광고를 번역합니다. 원본 언어와 화자 수를 알면 지정하고 음악과 주변음의 유지 여부를 고릅니다. 청취와 검토용 MP3 오디오가 결과로 나옵니다.
| 항목 | 값 |
|---|---|
| 입력 | 오디오 |
| 출력 | 오디오 |
| 개발사와 제품 | ElevenLabs — ElevenLabs Dubbing |
| 출시일 | 2023년 10월 10일 |
| 공개 오디오 API 이름 | elevenlabs/dubbing/audio-to-audio |
| 공개 영상 API 이름 | elevenlabs/dubbing/video-translate |
| 원본 길이 제한 | 15분; 더 긴 원본은 제출 시 거절 |
| 대상 언어 | 33개; |
| 원본 언어 | 57개 및 auto 감지 |
| 화자 수 | 1–32명; 자동 감지 시 |
| 배경음 | keep_background_audio로 음악과 주변음 유지 |
| 오디오 출력 관측 | MP3; 자체 오디오 테스트에서 4.50초, 44.1kHz 모노, 128kbps |
| 영상 출력 관측 | MP4; 자체 테스트에서 6.04초, 새 모노 AAC 오디오, 원본과 바이트 단위로 동일한 영상 스트림 |
| 과금 단위 | 원본 미디어의 초 수를 올림 |
핵심 기능 및 하이라이트
더빙 MP3 또는 번역 MP4
audio-to-audio는 녹음을 받아 더빙 MP3 오디오를 반환합니다. video-translate는 화면을 보존하고 음성 트랙을 교체한 MP4를 반환합니다. 둘 다 최대 15분 원본을 받으므로 필요한 결과 미디어에 따라 엔드포인트를 선택합니다.
대상 언어 33개와 화자 감지
대상 언어 33개와 원본 언어 57개 중 선택하거나 원본 자동 감지를 사용합니다. 출연자를 안다면 speaker_count를 1–32명으로 정하고 감지를 원하면 생략합니다. ElevenLabs는 더빙이 각 화자의 음성 특성을 번역된 말소리에 이어 준다고 설명합니다.
녹음의 배경음을 보존합니다
번역 녹음에 음악이나 주변음이 필요하면 keep_background_audio를 켭니다. 사용 전에 새 음성과의 균형을 검토합니다. 영상에서도 이 음향 선택은 촬영 화면을 바꾸거나 자막을 생성하지 않습니다.
자체 오디오 샘플 처리에 9.6초
자체 4.5초 영어·스페인어 오디오 테스트는 약 9.6초 처리 후 4.50초 MP3를 반환했습니다. 파일은 44.1kHz 모노, 128kbps였습니다. 별도의 6.04초 영상은 약 14.8초에 새 모노 AAC 트랙을 담은 MP4를 반환했으며 모두 샘플 관측입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | audio_url로 번역할 녹음을 최대 15분 길이로 제공합니다. 긴 자료는 제출 전에 자르거나 나누고 더빙 허락을 받은 녹음을 사용합니다. 1자 이상 |
target_language | 아니요 | 지원 대상 33개 중 언어를 고릅니다. 기본값은 en이므로 영어 외에 스페인어 등이 필요하면 명시적으로 지정합니다. |
source_language | 아니요 | 감지는 auto로 설정하거나 지원 원본 언어 57개 중 말하는 언어를 지정합니다. 언어를 이미 아는 짧은 샘플을 확인할 때 명시적 선택이 유용합니다. |
speaker_count | 아니요 | 서로 다른 화자 수를 1–32의 정수로 제공하거나 필드를 생략해 감지합니다. 인터뷰에서는 발화 차례가 아니라 사람 수를 셉니다. |
keep_background_audio | 아니요 | 번역 음성 아래에 음악과 주변음을 남기려면 켭니다. 오디오를 전달하기 전에 더빙 음성과 유지된 배경음을 함께 검토합니다. 기본값: |
요금
$0.012 / 초
원본 녹음의 초 수를 다음 정수 초로 올려 과금하며 원본은 최대 15분까지입니다. 언어와 화자 선택은 요율을 바꾸지 않고 실패한 작업에는 요금이 없습니다.
활용 사례
스페인어 팟캐스트 인터뷰
12분 영어 인터뷰를 audio_url로 제출하고 es를 고른 뒤 진행자와 게스트에 맞게 speaker_count를 2로 설정합니다. 오디오 엔드포인트가 반환한 번역 MP3를 검토해 스페인어판에 넣습니다.
고객 소식의 영어 음성판
번역에 동의한 동료가 녹음한 45초 음성 메모를 제공하고 대상을 en으로 지정합니다. 더빙 MP3를 받아 소식을 공유하기 전에 검토합니다.
화면과 함께 보는 강의
6분 화면 녹화 강의를 video_url로 보내고 의도한 대상 언어를 선택합니다. MP4는 화면 시연을 유지하면서 말소리 트랙을 교체하며, 필요하면 자막을 따로 만듭니다.
음악이 있는 오디오 광고
권한이 있는 30초 광고 녹음에 keep_background_audio를 켭니다. 번역된 음성 아래 기존 음악이나 주변음을 유지한 MP3가 출력됩니다.
다른 시장용 제품 시연
90초 제품 사용 영상을 영상 입력으로 제공하고 지원 대상 언어를 고릅니다. 같은 화면과 더빙 음성이 담긴 MP4를 받아 출시 전 언어 검토에 사용할 수 있습니다.
프롬프트 가이드 및 실전 팁
허락된 녹음을 준비합니다
본인 녹음이나 더빙에 동의한 화자의 자료로 15분 이내 오디오 또는 영상을 고릅니다. 말소리와 음악에 대한 사용 권리를 확인합니다.
언어와 화자를 정합니다
대상 언어 33개 중 선택하고 원본은 자동 감지 또는 언어 57개 중 하나로 지정합니다. 알고 있다면 speaker_count를 1–32명으로 넣고 배경 음향 유지 여부를 정합니다.
더빙 요청을 제출합니다
Bearer 인증과 {"model":"elevenlabs/dubbing/audio-to-audio","input":{"
audio_url":"https://example.com/narration.mp3","target_language":"es"}} 같은 JSON으로 POST https://api.spicyapi.ai/api/v1/jobs/createTask를 보냅니다. 영상은 elevenlabs/dubbing/video-translate를 선택하고 video_url을 대신 제공합니다.미디어를 받아 검토합니다
state가 succeeded가 될 때까지 GET /api/v1/jobs/recordInfo?taskId=로 읽은 뒤 반환 자산을 다운로드합니다. 번역된 말소리와 화자 전환을 확인합니다. 영상 더빙의 입술 움직임은 촬영 당시 그대로입니다.
오디오 번역을 위한 ElevenLabs Dubbing API
ElevenLabs Dubbing API는 오디오 녹음을 대상 언어 33개 중 하나의 더빙 MP3 음성으로 번역합니다. 최대 15분 원본 녹음으로 팟캐스트, 음성 메모, 내레이션, 오디오 광고를 제작하는 엔드포인트입니다.
ElevenLabs는 더빙 문서에서 원래 화자의 음성 특성이 보존된다고 설명합니다. 유사성은 자체 자료에서 검토합니다. 자체 짧은 테스트는 출력 형식과 처리 관측을 보여 주며 번역이나 음성 품질 전반을 평가한 것은 아닙니다.
오디오 더빙 작업 제출
공개 모델 이름 elevenlabs/dubbing/audio-to-audio와 함께 input에 녹음과 언어 설정을 넣습니다. Authorization: Bearer <SPICY_API_KEY>와 Content-Type: application/json을 사용해 아래 JSON을 https://api.spicyapi.ai/api/v1/jobs/createTask로 POST합니다.
{
"model": "elevenlabs/dubbing/audio-to-audio",
"input": {
"audio_url": "https://example.com/english-interview.mp3",
"target_language": "es",
"source_language": "en",
"speaker_count": 2,
"keep_background_audio": true
}
}
화자 2명의 영어 인터뷰에서 배경음을 유지하며 스페인어 음성을 요청하는 예제입니다. 예시 URL을 본인 녹음으로 바꾸고 화자 감지를 원하면 speaker_count를 생략합니다.
완료 MP3 결과 읽기
완료 작업은 더빙 MP3가 담긴 미디어 자산을 제공합니다. 반환된 taskId로 GET /api/v1/jobs/recordInfo?taskId=<taskId>를 같은 인증과 함께 호출하고, 다운로드 전에 작업 상태를 읽습니다.
{
"code": 200,
"data": {
"taskId": "<taskId>",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://example.com/dubbed-interview.mp3",
"mime": "audio/mpeg"
}
]
}
}
}
축약 응답은 완료 작업 구조를 보여 주며 URL은 예시입니다. 제출된 작업은 완성 녹음이 아니므로 자산이 준비됐다고 판단하기 전에 succeeded를 기다립니다.
오디오 매개변수와 한도
오디오 요청은 필수 녹음에 언어, 화자, 배경음 선택을 조합합니다.
| 매개변수 | 허용 값 또는 범위 | 활용 방법 |
|---|---|---|
audio_url | 원본 오디오, 최대 15분 | 번역할 권리가 있는 녹음을 제공합니다 |
target_language | 언어 33개; 기본값 en | 스페인어 출력은 es로 설정합니다 |
source_language | auto 또는 원본 언어 57개 | 아는 원본 언어를 지정하거나 감지합니다 |
speaker_count | 1–32명; 감지하려면 생략 | 인터뷰의 서로 다른 사람 수를 셉니다 |
keep_background_audio | 배경음 유지 스위치 | 더빙 음성 아래 음악과 주변음을 남깁니다 |
15분을 넘는 녹음은 제출 시 거절됩니다. 긴 에피소드는 주제나 화자가 바뀌는 적절한 경계에서 나누고 번역 구간을 배치할 때 연결부를 검토합니다.
원본 길이 기준 가격
오디오 더빙은 원본 녹음의 초 수를 정수 초로 올려 과금합니다. 예산을 세울 때 이 페이지의 표시 가격을 참고하며 처리 대기 시간은 과금할 미디어 길이가 아닙니다.
계산 기준은 MP3 파일 크기가 아니라 제출한 원본의 길이입니다. 낯선 언어나 어려운 화자 전환을 평가할 때는 긴 녹음을 보내기 전에 짧은 발췌문을 준비합니다.
자체 영어·스페인어 오디오 테스트
자체 4.5초 영어 원본은 약 9.6초 처리 후 4.50초 스페인어 MP3를 반환했습니다. 출력은 44.1kHz 샘플링, 오디오 채널 1개, 128kbps 인코딩을 사용했습니다.
길이가 일치한 것은 이 샘플의 관측이며 모든 번역의 타이밍이 같다는 근거는 아닙니다. 이 결과로 15분 팟캐스트의 처리 시간이나 대상 언어 33개 전체의 결과도 확정할 수 없습니다.
녹음 개선과 더빙 검토
명확한 대화와 구체적인 검토 계획은 번역 녹음이 청중에게 적합한지 판단하는 데 도움이 됩니다. 전체 프로젝트에서 중요한 이름, 용어, 화자 전환이 담긴 대표 구간을 사용합니다.
- 알아들을 수 있는 발화 구간을 고르고 화자의 허락을 확인합니다.
- 알고 있는 원본 언어를 정한 뒤 의도한 대상 언어를 명시합니다.
- 화자 수를 알면 입력하고 감지를 사용하려면 생략합니다.
- 결과물에 배경 음악이 필요한지 정하고 유지 여부를 설정합니다.
- 대상 언어를 아는 청취자에게 의미, 발음, 발화 전환을 확인받습니다.
깨끗한 내레이션 샘플은 겹치는 인터뷰 대화를 대표하지 않습니다. 끼어드는 발화를 듣고 번역된 각 대사를 누가 말하는지 비교합니다. 화자 수 입력은 이 검토를 대신하지 않습니다.
문제 해결 또는 다른 흐름 선택
거절된 요청을 다시 제출하기 전에 지나치게 긴 원본이나 범위 밖 화자 수를 수정합니다. 작업이 실패하면 다시 시도하기 전에 오류 내용을 읽고 제출 녹음과 언어 선택을 확인합니다.
원본 화면에 번역 음성을 입힌 MP4가 필요하면 elevenlabs/dubbing/video-translate를 선택합니다. 입 모양도 바꿔야 하는 영상은 HeyGen Video Translate를 고려하며 Video Translator V1도 영상 번역 대안입니다. 본인 또는 동의한 화자의 녹음을 사용하고 실제 사람을 사칭하지 않습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/dubbing/audio-to-audio",
"input": {
"audio_url": "https://example.com/reference.mp3",
"source_language": "auto",
"target_language": "en"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.




