> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# API 인증

## API 키

> **Tip**
>
> 키 설정은 건너뛰세요. 코딩 에이전트가 설정하도록 하세요.
>
> Claude Code, Cursor 또는 Codex에 아래 내용을 붙여 넣으세요. 로그인하거나 계정을 만들고, 키를 생성한 뒤 프로젝트에 SDK를 추가합니다.
>
> ```text
> Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.
> ```
>
> [작동 방식 보기](/docs/ko/eleven-api/quickstart#set-up-with-your-coding-agent) 또는 [`onboard` 명령어의 소스](https://github.com/elevenlabs/cli/tree/main/cli/elevenlabs/workflow/onboard)를 확인하여 에이전트에 정확히 어떤 내용을 전달하는지 알아보세요.

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

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

1. **범위 제한:** 키가 액세스할 수 있는 API 엔드포인트를 제한하여 접근 권한을 설정합니다.
2. **크레딧 할당량:** 사용량을 제어할 수 있도록 맞춤 크레딧 한도를 정의합니다.
3. **IP 허용 목록:** 키를 특정 IP 주소 또는 CIDR 범위로 제한합니다. 허용 목록에 없는 IP에서의 요청은 `403` 오류와 함께 거부됩니다. [자세히 알아보기](/docs/ko/overview/administration/workspaces/api-keys#ip-allowlisting).

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

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

```bash
xi-api-key: ELEVENLABS_API_KEY
```

### 요청 보내기

아래 명령어를 터미널에 붙여 넣어 첫 API 요청을 실행할 수 있습니다. `$ELEVENLABS_API_KEY`를 비밀 API 키로 반드시 교체하세요.

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

`elevenlabs` Python 패키지를 사용한 예시:

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

`elevenlabs` Node.js 패키지를 사용한 예시:

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});
```

### 일회용 토큰

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

자세한 내용은 [일회용 토큰](/docs/ko/api-reference/tokens/create) 문서를 참조하세요.