소개
연기한 내레이션이나 캐릭터 대사를 audio_url로 제공하고 voice_id로 기본 제공 음성 41개 중 선택해 목소리를 바꿉니다. 기본값은 Alicia이며 remove_background_noise로 선택적 소음 제거를 켭니다. 제작물에 사용하기 전에 반환 MP3를 원본과 대조합니다.
| 항목 | 값 |
|---|---|
| 입력 | 오디오 |
| 출력 | 오디오 |
| 개발사 | ElevenLabs |
| 출시 | 2023년 11월 22일; 음성 간 변환으로 소개 |
| 공개 API 이름 | elevenlabs/voice-changer/audio-to-audio |
| 원본 입력 | audio_url로 제공하는 발화 녹음; 최대 5분 |
| 음성 선택 | voice_id로 기본 제공 ElevenLabs 음성 41개 선택 |
| 기본 음성 | Alicia |
| 사용자 지정·복제 음성 | 이 엔드포인트에서는 미지원 |
| 소음 제어 |
|
| 변환 미디어 | MP3; 같은 단어와 타이밍을 다른 음성으로 전달 |
| 과금 단위 | 원본 오디오의 초 수를 정수 초로 올림 |
| MP3 실측 | 4.50초; 44.1kHz 모노; 128kbps; Brian 음성 |
| 처리 실측 | 4.5초 영어 내레이션 처리에 약 3.7초 |
핵심 기능 및 하이라이트
본인의 음성으로 연기를 지시합니다
입력 녹음이 단어와 타이밍을 제공합니다. ElevenLabs에 따르면 Voice Changer는 원본 억양과 속도를 보존하므로 연기한 임시 낭독으로 변환 음성을 이끌 수 있습니다. 필요한 곳에 쉼이나 강세를 녹음하고 선택 음성이 이를 어떻게 전달하는지 평가합니다.
같은 녹음으로 음성 41개를 들어 봅니다
voice_id로 기본 제공 음성을 고르고 선택지를 비교할 때 원본 녹음을 고정합니다. 기본값은 Alicia이며 자체 실측에서는 Brian을 사용했습니다. 사용자 지정·복제 음성은 이 엔드포인트에서 지원하지 않으므로 목록의 음성 안에서 내레이터를 계획합니다.
짧은 내레이션에서 얻은 4.50초 MP3
자체 영어 내레이션 테스트는 4.5초였고 Brian으로 변환하는 데 약 3.7초가 걸렸습니다. 결과 MP3는 4.50초, 44.1kHz 모노, 128kbps였습니다. 로컬 받아쓰기에서는 원본 문장의 단어가 모두 재현됐으며 이 관측은 해당 녹음에 한정됩니다.
배경 소음 제거 여부를 선택합니다
remove_background_noise 스위치로 원본 발화의 소음 제거를 요청합니다. 짧은 구절을 켜짐과 꺼짐으로 비교한 뒤 자음이 명확하고 쉼이 자연스러운지 듣습니다. 음성을 들어 볼 때는 설정과 녹음 조건을 일정하게 유지합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 변환 허락을 받은 발화 녹음의 URL을 최대 5분 길이로 제공합니다. 해당 길이를 올림한 값이 과금할 원본 초 수가 됩니다. 1자 이상 |
voice_id | 아니요 | Brian 같은 목록의 기본 제공 음성을 고르거나 Alicia를 사용하려면 생략합니다. 선택지는 음성 41개이며 사용자 지정·복제 음성은 받지 않습니다. |
remove_background_noise | 아니요 | 배경 소음 제거를 요청하려면 불리언을 true로, 끄려면 false로 지정합니다. 긴 녹음을 변환하기 전에 두 설정으로 짧은 구절을 비교합니다. 기본값: |
요금
$0.0048 / 초
입력 녹음의 초 수를 다음 정수 초로 올려 과금하며 최소 1초, 최대 5분입니다. 음성과 소음 설정에 따른 가격 변화는 없습니다. 작업이 실패하면 청구하지 않습니다.
활용 사례
임시 내레이터의 목소리 교체
화면 단계에 맞는 쉼을 넣어 직접 녹음한 튜토리얼 도입부를 제공합니다. 기본 제공 음성으로 변환한 MP3를 받아 편집본과 내레이션을 맞춰 검토합니다.
게임 캐릭터 대사 시안
변환에 동의한 배우에게 ‘문이 열렸어요. 따라오세요.’ 같은 대사를 녹음하도록 합니다. 목록의 음성으로 바꿔 배우의 타이밍과 감정 연기를 따르는 MP3를 얻습니다.
인터뷰 화자의 목소리 변경
화자가 음성 변환을 허락한 짧은 인터뷰 답변을 입력으로 사용합니다. 다른 기본 제공 음성으로 답변하는 MP3가 반환되며 공유 전 단어와 화자의 동의를 검토합니다.
보이스오버 연기 비교
사용할 강세로 제품 안내 구간을 녹음한 뒤 같은 발췌문에 서로 다른 음성을 지정해 제출합니다. 나머지를 처리하기 전에 MP3 결과를 비교해 내레이터를 고릅니다.
프롬프트 가이드 및 실전 팁
허가받은 발화 녹음을 준비합니다
원하는 단어, 쉼, 감정을 담아 최대 5분으로 녹음합니다. 첫 사용 전에 웹사이트의 음성 유사성과 동의 안내를 수락하고 녹음을 변환할 권리가 있는지 확인합니다.
기본 제공 목소리를 고릅니다
사용 가능한 음성 41개 중 voice_id를 선택하거나 Alicia를 쓰려면 생략합니다. 원본에 remove_background_noise를 적용할지 정합니다.
audio-to-audio를 호출합니다
audio_url, 선택한voice_id,remove_background_noise불리언을 포함한 JSON으로 elevenlabs/voice-changer/audio-to-audio를 호출합니다. README에는 이 필드를 사용한 Brian 요청이 있습니다.반환된 MP3를 검토합니다
변환 MP3를 원본과 비교해 들으며 문구, 쉼, 문장 끝을 확인합니다. 입력 길이를 정수 초로 올리고 표시 가격을 적용해 요금을 파악합니다.
ElevenLabs Voice Changer API: 녹음 발화를 새 목소리로
ElevenLabs Voice Changer는 기존 연기의 단어와 타이밍을 유지하면서 목소리를 바꾸는 ElevenLabs의 음성 간 변환 도구입니다. 최대 5분 발화 녹음으로 elevenlabs/voice-changer/audio-to-audio를 호출해 선택한 기본 제공 음성의 MP3를 받습니다.
ElevenLabs는 원본 억양과 속도가 변환 음성에 이어진다고 설명합니다. Voice Changer 발표에서 연기된 발화를 보존한다고 소개하므로 청취자에게 들려줄 쉼과 강조를 녹음합니다.
audio-to-audio 요청 만들기
audio_url을 제공하고 기본 제공 voice_id를 골라 녹음을 변환합니다. 아래 설명용 JSON 입력은 배경 소음 제거 없이 Brian을 요청합니다. elevenlabs/voice-changer/audio-to-audio를 호출할 때 예시 URL을 허가받은 원본 녹음으로 바꿉니다.
{
"audio_url": "https://example.com/permitted-scratch-read.wav",
"voice_id": "Brian",
"remove_background_noise": false
}
- 입력 한도 5분 안에서 발화 녹음을 준비합니다.
- 첫 사용 전 웹사이트에서 음성 유사성과 동의 안내를 수락합니다.
- 지정된 엔드포인트에 JSON 입력을 제출합니다.
- 편집본에 쓰기 전에 결과 MP3를 원본과 대조해 검토합니다.
응답 미디어 이해
엔드포인트의 미디어 결과는 선택한 음성으로 원본 단어와 타이밍을 전달하는 MP3입니다. 다음 응답 예제는 실측 미디어 결과를 설명하며 API 응답 구조나 모든 변환의 인코딩을 약속하지 않습니다.
Converted audio: MP3
Selected voice: Brian
Duration: 4.50 seconds
Sample rate: 44.1 kHz
Channels: mono
Bitrate: 128 kbps
이 예제로 출력 검사를 계획합니다. 단어를 듣고 쉼 위치를 비교하며 파일 길이를 확인합니다. 바뀐 단어나 어색한 전환을 찾을 수 있도록 원본을 보관합니다.
입력 매개변수 3개 설정
요청은 오디오 URL, 기본 제공 음성 선택, 선택적 소음 제거 스위치를 사용합니다. 대본을 다시 쓰는 prompt 필드는 없으므로 원하는 문구를 입력 녹음에서 연기합니다.
| 매개변수 | 값 또는 한도 | 활용 시 참고 |
|---|---|---|
audio_url | 원본 발화 URL; 최대 5분 | 유지할 낭독이 담긴 허가된 녹음을 사용합니다. |
voice_id | 기본 제공 음성 41개; 기본값 Alicia | Brian 같은 목록의 음성을 고르며 Alicia는 필드를 생략합니다. |
remove_background_noise | 불리언: true 또는 false | 배경 소음 제거를 요청하려면 켭니다. |
이 엔드포인트에서는 사용자 지정·복제 음성을 사용할 수 없습니다. 따라서 다른 음성 작업에서 썼더라도 개인 음성 식별자는 여기에 적합하지 않습니다.
길이 기준 요금 계산
원본 오디오 초 수를 다음 정수 초로 올려 과금합니다. 변환 비용을 추정할 때 이 페이지의 현재 표시 가격을 사용하며 기준이 되는 길이는 원본 녹음입니다.
전체 내레이션을 변환하기 전에 발췌문을 들어 봅니다. 같은 발췌문을 음성별로 비교해 내레이터를 고른 뒤 나머지 발화를 처리합니다.
효과적인 원본 연기 준비
의도적으로 낭독한 원본은 변환이 따를 명확한 연기를 제공합니다. 화면 동작에 맞는 쉼을 담아 튜토리얼 도입부를 녹음하거나 동의한 배우에게 원하는 감정으로 캐릭터 대사를 연기하도록 합니다.
- 이름과 문장 끝을 포함해 정확한 대본대로 말하고 제출 전에 검토합니다.
- 기본 제공 음성을 비교할 때 같은 원본 녹음을 써서 연기를 고정합니다.
- 말소리와 쉼이 모두 담긴 구간으로 소음 제거의 켜짐과 꺼짐을 비교합니다.
- 낭독을 바꿔야 하는 구절은 다시 녹음한 뒤 수정 구간을 변환합니다.
자체 실측 결과 해석
자체 테스트에서는 4.5초 영어 내레이션을 Brian으로 바꾸는 데 처리 시간 약 3.7초가 걸렸습니다. 출력은 4.50초 MP3, 44.1kHz 모노, 128kbps였으며 로컬 받아쓰기에서 원본 문장의 단어가 모두 일치했습니다.
이 결과는 해당 짧은 내레이션을 뒷받침하며 본인 자료의 동일한 처리 시간이나 단어 정확도를 보장하지 않습니다. 긴 연속 변환 일정을 정하기 전에 대표 구절에서 품질과 경과 시간을 비교합니다.
입력과 청취 문제 해결
5분을 넘는 원본은 이 엔드포인트의 길이 한도를 초과합니다. 한도 안의 구절로 나누고 변환 MP3를 조립할 때 연결부를 검토합니다.
지원하지 않는 음성은 목록의 기본 제공 음성으로 바꾸거나 생략해 Alicia를 선택합니다. 들리는 목소리나 억양이 예상과 다르면 같은 또렷한 구절로 여러 선택지를 비교합니다. 원본 연기가 계속 발화를 이끌기 때문입니다.
잡음이 남는 결과는 remove_background_noise를 켜고 짧게 비교합니다. 단어가 어색하면 원본을 확인하고 해당 구절을 다시 또렷하게 말한 뒤 새 출력을 검토합니다. 받아쓰기 테스트 1건의 성공을 보장으로 취급하지 않습니다.
목소리 변환, 번역, 새 대본 중 선택
목소리 변환은 기존 연기 녹음에 적합하며 번역은 다른 작업 흐름이 필요합니다. 아래 구분으로 다음에 제출할 내용을 정합니다.
| 시작 자료와 목표 | 선택할 작업 흐름 |
|---|---|
| 단어와 타이밍을 유지할 발화 녹음 | 이 Voice Changer audio-to-audio 엔드포인트 |
| 대상 언어로 바꿔야 할 녹음 발화 | ElevenLabs Dubbing |
| 아직 낭독되지 않은 작성 대본 | 텍스트 음성 변환 흐름 |
음성 변환 전 허락 확인
웹사이트는 Voice Changer 첫 사용 전에 음성 유사성과 동의 안내 수락을 요구합니다. 사용할 권리가 있는 텍스트와 음성을 이용하고 본인 발화나 변환 허락을 받은 녹음을 변환하며 실제 사람을 사칭하지 않습니다.
사용 권리가 있는 텍스트와 음성을 이용하고 본인 발화나 변환 허락을 받은 녹음을 변환합니다. 변환 오디오로 실제 인물을 사칭하지 않습니다. 첫 사용 전 웹사이트의 음성 유사성과 동의 안내를 수락합니다.
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/voice-changer/audio-to-audio",
"input": {
"audio_url": "https://example.com/reference.mp3",
"voice_id": "Alicia"
}
}'
# 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 레퍼런스에서 확인하세요.




