ダッシュボードでキーを作成し、サーバーに保存して、GatewayのリクエストにBearerトークンとして送信してください。
キーの種類
- Gateway API キーは、ワークスペースで利用可能なモデル、プロバイダー、生成エンドポイントを呼び出します。
- 管理 API キーは、管理用 API を呼び出します。管理 API キーを参照してください。
古い認証情報を無効にする前に、アプリケーションを代わりのキーに切り替えてキーローテーションを行います。キーローテーションのエンドポイントを参照してください。
キーの形式は phaseo_v1_sk_<kid>_<secret> です。 パスワードと同じように扱い、クライアント側のコードや公開リポジトリに保存しないでください。
クレジットを入金せずに :free モデルを呼び出せます。有料モデルにはウォレット残高が必要です。
ヘッダー形式
すべてのリクエストの Authorization ヘッダーにキーを含めます。
ほとんどの HTTP クライアントでは、この設定を一度だけ行えます。fetch の例:
キー管理のチェックリスト
よくある認証エラー
- 401 認証されていません:キーがないか無効であるか、無効化されたワークスペースに属しています。
- 403 禁止されています:キーは存在しますが、要求されたプロバイダーまたはモデルにアクセスできません。
- 429 Too Many Requests:キーまたはワークスペースが上限を超えました。リクエスト制限を参照してください。
- 5xx エラー:指数バックオフで再試行し、問題が続く場合はサポートにお問い合わせください。