> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> 모든 Supertone API 요청은 `x-sup-api-key` 헤더로 전달되는 API 키로 인증합니다.

<Note>
  이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 [영어 원문](/en/api-reference/authentication)을 함께 확인해 주세요.
</Note>

Supertone API는 커스텀 헤더 기반의 API 키 인증 방식을 사용합니다.

## 헤더

```http theme={"dark"}
x-sup-api-key: <YOUR_API_KEY>
```

모든 요청에 이 헤더를 포함해 주십시오. 키가 누락되거나 유효하지 않으면 `401 Unauthorized`가 반환되며, 해당 리소스에 대한 권한이 없는 키는 `403 Forbidden`을 반환합니다.

## 키 발급

[개발자 콘솔](https://console.supertoneapi.com)에 로그인한 뒤 새 키를 생성해 주십시오. 계정당 최대 **3개의 활성 키**를 보유할 수 있으며, 콘솔에서 언제든 폐기하고 재발급할 수 있습니다.

## 예시

```bash theme={"dark"}
curl https://supertoneapi.com/v1/voices \
  -H "x-sup-api-key: $SUPERTONE_API_KEY"
```

## 인증 오류

| Status             | Cause                                                  |
| ------------------ | ------------------------------------------------------ |
| `401 Unauthorized` | API 키가 누락되었거나, 형식이 올바르지 않거나, 폐기되었습니다.                  |
| `403 Forbidden`    | 유효한 키이지만 해당 리소스에 대한 권한이 없습니다(예: 다른 계정 소유의 커스텀 보이스 호출). |

전체 오류 목록과 권장 대응 방법은 [오류 처리](/ko/docs/production/error-handling)를 참고해 주십시오.

## 함께 보기

<CardGroup cols={2}>
  <Card title="Docs: Authentication" icon="key" href="/ko/docs/authentication">
    설정 가이드, 환경 변수 규칙, 보안 체크리스트입니다.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/ko/docs/quickstart">
    키를 설정하고 5분 안에 첫 호출을 완료합니다.
  </Card>
</CardGroup>