認証
キーの送信方法、各形式で必要なヘッダー、キーを安全に保つ方法。
すべてのリクエストには、ダッシュボードで作成したAPIキーが必要です。キーの先頭は sk- で、作成元のアカウントの権限と残高が適用されます。
どちらのヘッダーでも同じキー
同じキーを両方の形式で使用できます。変わるのはヘッダー名だけです。
| 形式 | エンドポイント | ヘッダー |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
Anthropic形式では、バージョンヘッダーも必要です。Anthropic SDKでは自動的に設定されます。
-H "anthropic-version: 2023-06-01"環境変数
ほとんどのツールは、キーを引数として受け取るのではなく、以下の環境変数を読み取ります。
| 変数 | 使用するツール | 値 |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code、Anthropic SDK | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | ご自身の sk- キー |
ANTHROPIC_API_KEY | Anthropic SDK（Python/TS） | ご自身の sk- キー |
OPENAI_BASE_URL | OpenAI SDK、LangChain、LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | OpenAI SDK | ご自身の sk- キー |
次の
/v1 にはサフィックスを付けます： OPENAI_BASE_URL 一方、こちらには付けません： ANTHROPIC_BASE_URL。この違いは公式SDKの仕様によるもので、当サービスが導入したものではありません。OpenAIクライアントは指定されたベースURLにパスを追加し、Anthropicクライアントは /v1 を自動で追加します。ここを間違えることが、最もよくある設定エラーです。キーの安全な管理
- 次のキーを作成します： マシンやプロジェクトごとに別のキー を使用すると、ほかに影響を与えずに個別のキーを失効させられます。
- キーは絶対にコミットしないでください。環境変数またはシークレットマネージャーを使用し、次を追加してください：
.envで、変更後の値は.gitignore. - キーの全文が表示されるのは 一度だけです。紛失したキーを復元しようとせず、新しいキーに切り替えてください。
- 漏えいしたキーは残高を消費します。ダッシュボードですぐに失効させてください。失効は即時に反映されます。
- サーバー側からの呼び出しを推奨します。ブラウザーのバンドルやモバイルアプリに含めて配布したキーは、誰でも入手できるキーです。
失効とローテーション
- ダッシュボード → API キー.
- まず新しいキーを作成し、デプロイします。
- トラフィックが新しいキーに移ったら、古いキーを削除します。古いキーを使用して処理中のリクエストは、削除直後に失敗します。