API reference

소개

종합 가이드, 코드 예시 및 엔드포인트 문서로 ElevenLabs API 레퍼런스를 살펴보세요

설치

공식 Python 바인딩 또는 공식 Node.js 라이브러리를 통해 어떤 언어에서든 HTTP 또는 WebSocket 요청으로 API와 상호작용할 수 있습니다.

공식 Python 바인딩을 설치하려면 다음 명령어를 실행하세요.

pip install elevenlabs

공식 Node.js 라이브러리를 설치하려면 Node.js 프로젝트 디렉터리에서 다음 명령어를 실행하세요.

npm install @elevenlabs/elevenlabs-js

생성 비용 추적

응답 헤더에 액세스하여 문자 비용을 포함한 생성 메타데이터를 확인하세요.

from elevenlabs.client import ElevenLabs
client = ElevenLabs(api_key="your_api_key")
# Get raw response with headers
response = client.text_to_speech.with_raw_response.convert(
    text="Hello, world!",
    voice_id="voice_id"
)
# Access character cost from headers
char_cost = response.headers.get("character-cost")
# Optionally store these for debugging
request_id = response.headers.get("request-id")
trace_id = response.headers.get("x-trace-id")
audio_data = response.data

원시 응답에서는 다음 항목에 액세스할 수 있습니다.

  • 응답 데이터 - 실제 API 응답 콘텐츠
  • HTTP 헤더 - 문자 비용 및 요청 ID를 포함한 메타데이터