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

# 認証

> Phaseo Gateway へのすべてのリクエストを API キーで認証します。

[ダッシュボード](https://phaseo.app/gateway/keys)でキーを作成し、サーバーに保存して、GatewayのリクエストにBearerトークンとして送信してください。

***

## キーの種類

* **Gateway API キー**は、ワークスペースで利用可能なモデル、プロバイダー、生成エンドポイントを呼び出します。
* **管理 API キー**は、管理用 API を呼び出します。[管理 API キー](./management-api-keys.mdx)を参照してください。

古い認証情報を無効にする前に、アプリケーションを代わりのキーに切り替えてキーローテーションを行います。[キーローテーションのエンドポイント](../api-reference/endpoint/keys-rotate.mdx)を参照してください。

キーの形式は `phaseo_v1_sk_<kid>_<secret>` です。 パスワードと同じように扱い、クライアント側のコードや公開リポジトリに保存しないでください。

<Note>
  クレジットを入金せずに `:free` モデルを呼び出せます。有料モデルにはウォレット残高が必要です。
</Note>

***

## ヘッダー形式

すべてのリクエストの `Authorization` ヘッダーにキーを含めます。

```http theme={null}
Authorization: Bearer phaseo_v1_sk_<kid>_<secret>
```

ほとんどの HTTP クライアントでは、この設定を一度だけ行えます。`fetch` の例：

```ts theme={null}
const response = await fetch("https://api.phaseo.app/v1/chat/completions", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		model: "openai/gpt-5-nano",
		messages: [
			{ role: "system", content: "You are a helpful assistant." },
			{
				role: "user",
				content: "Summarize the drawbacks to AI.",
			},
		],
	}),
});
```

***

## キー管理のチェックリスト

| 実践方法 | 理由 |
| - | - |
| アプリごとにキーを分ける | ほかのサービスに影響を与えずにキーをローテーションできます。 |
| キーを安全に保管する | シークレットマネージャーを使えば、ログやエラー追跡ツールへの誤った流出を防げます。 |
| 使用状況を監視する | ダッシュボードではキーごとの指標を確認できるため、異常をすばやく検知できます。 |
| 使っていないキーを削除する | 古いキーを削除すると、悪用される可能性のある範囲を小さくできます。 |

***

## よくある認証エラー

* **401 認証されていません**：キーがないか無効であるか、無効化されたワークスペースに属しています。
* **403 禁止されています**：キーは存在しますが、要求されたプロバイダーまたはモデルにアクセスできません。
* **429 Too Many Requests**：キーまたはワークスペースが上限を超えました。[リクエスト制限](../api-reference/limits.mdx)を参照してください。
* **5xx エラー**：指数バックオフで再試行し、問題が続く場合は[サポート](https://phaseo.app/help)にお問い合わせください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.