탐색으로 건너뛰기
API reference

API 인증

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

API 키

키 설정은 건너뛰세요. 코딩 에이전트가 설정하도록 하세요.

Claude Code, Cursor 또는 Codex에 아래 내용을 붙여 넣으세요. 로그인하거나 계정을 만들고, 키를 생성한 뒤 프로젝트에 SDK를 추가합니다.

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

작동 방식 보기 또는 onboard 명령어의 소스를 확인하여 에이전트에 정확히 어떤 내용을 전달하는지 알아보세요.

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에 연결하는 데 사용할 수 있습니다.

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