APIMaster.ai

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()

독립 오디오 엔드포인트

과금 및 호환성

음성 합성은 문자 수, 다른 오디오 기능은 각 기능의 시간 단위로 측정합니다. 실시간 대화는 연결 시간과 토큰을 함께 계산합니다. 음성 디자인 미리 듣기 세 개에 대해 미리 듣기 텍스트를 한 번만 과금합니다. music_v1은 2027-01-31, eleven_text_to_sound_v2는 2027-03-01에 제거될 예정입니다.

공식 요금