APIMaster의 ElevenLabs API
`Authorization: Bearer` 헤더에 APIMaster API 키를 사용합니다. 엔드포인트에는 `/v1/elevenlabs` 접두사가 붙습니다. 매개변수 링크는 ElevenLabs 공식 문서로 연결됩니다.
Authorization: Bearer 헤더에 APIMaster API 키를 사용합니다. 엔드포인트에는 /v1/elevenlabs 접두사가 붙습니다. 매개변수 링크는 ElevenLabs 공식 문서로 연결됩니다.
로컬 파일을 업로드하세요. 원격 URL과 전사 웹훅은 사용할 수 없습니다. 음성 디자인에는 100자 이상의 미리 듣기 텍스트가 필요합니다. 음악과 효과음에는 길이를 지정합니다. APIMaster WebSocket이 업스트림 인증을 처리합니다. 오디오 커밋 후 response.create를 보내고 response.done을 기다립니다.
모델 및 엔드포인트
| 기능 | 모델 ID | 공식 엔드포인트 | 주요 매개변수 |
|---|---|---|---|
| 음성 합성 및 대화 | eleven_v4, eleven_v4_turbo, eleven_v3, eleven_v3_conversational, eleven_multilingual_v2, eleven_flash_v2_5, eleven_flash_v2, eleven_turbo_v2_5, eleven_turbo_v2 |
POST /v1/elevenlabs/text-to-speech/{voice_id} · POST /v1/elevenlabs/text-to-dialogue |
text · model_id · voice_settings · language_code · output_format · inputs[].voice_id · inputs[].text |
| 파일 전사 | scribe_v3, scribe_v2, scribe_v2_medical |
POST /v1/elevenlabs/speech-to-text |
model_id · file · language_code · diarize · timestamps_granularity · keyterms · transcript_edit |
| 실시간 전사 | scribe_v3_live, scribe_v2_realtime |
WSS /v1/elevenlabs/speech-to-text/realtime |
model_id · audio_format · commit_strategy · audio_base_64 · commit |
| 음성 변환 | eleven_multilingual_sts_v2, eleven_english_sts_v2 |
POST /v1/elevenlabs/voice-changer/{voice_id} |
audio · model_id · remove_background_noise · voice_settings · output_format |
| 음성 디자인 | eleven_ttv_v3, eleven_multilingual_ttv_v2 |
POST /v1/elevenlabs/text-to-voice/design |
model_id · voice_description · text · guidance_scale · seed |
| 효과음 | eleven_text_to_sound_v3, eleven_text_to_sound_v2 |
POST /v1/elevenlabs/sound-generation |
model_id · text · duration_seconds · loop · prompt_influence |
| 음악 | music_v2_5, music_v2, music_v1 |
POST /v1/elevenlabs/music |
model_id · prompt · composition_plan · music_length_ms · force_instrumental |
| 실시간 대화 | eleven_realtime_v1_mini, eleven_realtime_v1_max |
WSS /v1/elevenlabs/realtime |
model · input_audio_buffer.append · response.create |
| 더빙 | dubbing_v2, dubbing_v1 |
POST /v1/elevenlabs/dubbing/project |
model_id · file · source_language · target_language · project_id |
매개변수 및 응답
voice_id는 음성,model_id는 모델,language_code는 언어를 선택합니다.voice_settings로 표현을 조절합니다. 대화의inputs항목마다 텍스트와 음성을 지정합니다.file에 오디오를 업로드합니다.diarize로 화자를 구분하며timestamps_granularity로 타임스탬프 단위를 설정합니다. 실시간 전사는 PCM을 Base64 블록으로 보내고commit후committed_transcript를 기다립니다.- 음성 변환은
voice_id로 대상 음성을 지정합니다. 음성 디자인은 미리 듣기 세 개를 반환합니다.text에 100자 이상을 입력합니다. - 효과음의
duration_seconds는 0.5–30초입니다. 음악에는prompt또는composition_plan을 사용합니다.prompt와 함께music_length_ms로 길이를 정하고force_instrumental로 보컬을 제외합니다. - 더빙은
project_id로 프로젝트와 대상 언어 상태를 조회한 후outputs.lossless_audio를 다운로드합니다.
사용 예시
curl https://apimaster.ai/v1/elevenlabs/text-to-speech/JBFqnCBsd6RMkjVDRZzb \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model_id":"eleven_v4","text":"Hello from ElevenLabs."}' \
--output speech.mp3
curl https://apimaster.ai/v1/elevenlabs/speech-to-text \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-F 'model_id=scribe_v3' -F 'file=@speech.mp3' \
-F 'diarize=true' -F 'timestamps_granularity=word'
curl https://apimaster.ai/v1/elevenlabs/music \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model_id":"music_v2_5","prompt":"Soft piano jingle","music_length_ms":3000,"force_instrumental":true}' \
--output jingle.mp3
curl https://apimaster.ai/v1/elevenlabs/dubbing/project \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-F 'model_id=dubbing_v2' -F 'file=@speech.mp3' \
-F 'source_language=en' -F 'target_language=es'
curl "https://apimaster.ai/v1/elevenlabs/dubbing/project/$PROJECT_ID" \
-H "Authorization: Bearer $APIMASTER_API_KEY"
curl "https://apimaster.ai/v1/elevenlabs/dubbing/project/$PROJECT_ID/language/$LANGUAGE_ID" \
-H "Authorization: Bearer $APIMASTER_API_KEY"
요청 형식과 제한
음성 합성, 대화, 음성 디자인, 효과음, 음악은 최대 4 MiB의 application/json으로 전송합니다. output_format은 쿼리 문자열에 넣습니다. 여러 화자가 참여하는 대화에는 eleven_v4 또는 eleven_v3를 사용합니다. 합성, 대화, 음성 변환, 음악, 오디오 분리 경로 끝에 /stream을 붙이면 응답을 청크 단위로 받습니다.
multipart/form-data로 파일 한 개를 올립니다. 음성 변환과 오디오 분리에는 audio, 전사, 정렬, 스템 분리, 더빙에는 file을 사용합니다. 모노 16 kHz 16비트 리틀 엔디언 PCM에는 file_format=pcm_s16le_16을 사용합니다.
음악 길이는 3,000~600,000밀리초입니다. prompt를 보낼 때 music_length_ms를 지정합니다. composition_plan을 사용하면 각 세그먼트에 고정된 duration_ms를 지정합니다.
실시간 대화 예제
websocket-client를 설치하고 APIMASTER_API_KEY를 설정합니다. session.created 이후 입력을 전송합니다. 오디오는 response.audio.delta 또는 response.output_audio.delta로 수신합니다. response.done에서 응답 상태와 사용량을 확인합니다.
import json
import os
from urllib.parse import urlsplit, urlunsplit
from websocket import create_connection
base = urlsplit("https://apimaster.ai/v1")
url = urlunsplit(("wss", base.netloc, base.path.rstrip("/") + "/elevenlabs/realtime",
"model=eleven_realtime_v1_mini", ""))
socket = create_connection(
url, header={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
timeout=30,
)
try:
assert json.loads(socket.recv())["type"] == "session.created"
socket.send(json.dumps({
"type": "conversation.item.create",
"item": {"type": "message", "role": "user",
"content": [{"type": "input_text", "text": "Say hello."}]},
}))
socket.send(json.dumps({"type": "response.create"}))
while True:
event = json.loads(socket.recv())
if event["type"] == "error":
raise RuntimeError(event["error"])
if event["type"] == "response.done":
print(event["response"]["status"], event["response"].get("usage"))
break
finally:
socket.close()
독립 오디오 엔드포인트
POST /v1/elevenlabs/audio-isolation·audio,file_formatPOST /v1/elevenlabs/forced-alignment·file,textPOST /v1/elevenlabs/music/stem-separation·file,stem_variation_id(two_stems_v1,six_stems_v1)
과금 및 호환성
음성 합성은 문자 수, 다른 오디오 기능은 각 기능의 시간 단위로 측정합니다. 실시간 대화는 연결 시간과 토큰을 함께 계산합니다. 음성 디자인 미리 듣기 세 개에 대해 미리 듣기 텍스트를 한 번만 과금합니다. music_v1은 2027-01-31, eleven_text_to_sound_v2는 2027-03-01에 제거될 예정입니다.
