API reference

API 인증

ElevenLabs API 요청을 인증하는 방법을 알아보세요

API 키

ElevenLabs API는 인증에 API 키를 사용합니다. API에 보내는 모든 요청에는 요청을 인증하고 사용량 할당량을 추적하는 API 키가 포함되어야 합니다.

각 API 키에는 다음 제한을 구성할 수 있습니다.

  1. 범위 제한: 키가 액세스할 수 있는 API 엔드포인트를 제한하여 액세스 제한을 설정합니다.
  2. 크레딧 할당량: 사용량을 제어할 수 있도록 맞춤 크레딧 한도를 정의합니다.
  3. IP 허용 목록: 키를 특정 IP 주소 또는 CIDR 범위로 제한합니다. 허용 목록에 없는 IP의 요청은 403 오류와 함께 거부됩니다. 자세히 알아보기.

API 키는 비밀 정보라는 점을 기억하세요. 다른 사람과 공유하거나 클라이언트 측 코드(브라우저, 앱)에 노출하지 마세요.

모든 API 요청에는 다음과 같이 xi-api-key HTTP 헤더에 API 키를 포함해야 합니다.

xi-api-key: ELEVENLABS_API_KEY

요청 보내기

아래 명령어를 터미널에 붙여 넣어 첫 API 요청을 실행할 수 있습니다. $ELEVENLABS_API_KEY를 비밀 API 키로 바꾸세요.

curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'

elevenlabs Python 패키지 예시:

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)

elevenlabs Node.js 패키지 예시:

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

일회용 토큰

일부 엔드포인트에서는 일회용 토큰을 사용해 요청을 인증할 수 있습니다. 이 토큰은 제한된 시간 동안 유효하며, 예를 들어 클라이언트 측에서 API 키를 노출하지 않고 API에 연결하는 데 사용할 수 있습니다.

자세한 내용은 일회용 토큰 문서를 참조하세요.