> ## 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) にサインインして新しいキーを作成します。**1 アカウントあたり最大 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`    | キーは有効ですが、リソースへの権限がありません（例: 別アカウントが所有するカスタムボイスの呼び出し）。 |

エラーカタログの全体および推奨レスポンスについては [エラーハンドリング](/ja/docs/production/error-handling) をご参照ください。

## 関連項目

<CardGroup cols={2}>
  <Card title="Docs: Authentication" icon="key" href="/ja/docs/authentication">
    セットアップ手順、環境変数の規約、セキュリティチェックリスト。
  </Card>

  <Card title="Quickstart" icon="rocket" href="/ja/docs/quickstart">
    キーを設定し、5 分で最初のコールを実行します。
  </Card>
</CardGroup>