Skip to main content
ダッシュボードでキーを作成し、サーバーに保存して、GatewayのリクエストにBearerトークンとして送信してください。

キーの種類

  • Gateway API キーは、ワークスペースで利用可能なモデル、プロバイダー、生成エンドポイントを呼び出します。
  • 管理 API キーは、管理用 API を呼び出します。管理 API キーを参照してください。
古い認証情報を無効にする前に、アプリケーションを代わりのキーに切り替えてキーローテーションを行います。キーローテーションのエンドポイントを参照してください。 キーの形式は phaseo_v1_sk_<kid>_<secret> です。 パスワードと同じように扱い、クライアント側のコードや公開リポジトリに保存しないでください。
クレジットを入金せずに :free モデルを呼び出せます。有料モデルにはウォレット残高が必要です。

ヘッダー形式

すべてのリクエストの Authorization ヘッダーにキーを含めます。
ほとんどの HTTP クライアントでは、この設定を一度だけ行えます。fetch の例:

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


よくある認証エラー

  • 401 認証されていません:キーがないか無効であるか、無効化されたワークスペースに属しています。
  • 403 禁止されています:キーは存在しますが、要求されたプロバイダーまたはモデルにアクセスできません。
  • 429 Too Many Requests:キーまたはワークスペースが上限を超えました。リクエスト制限を参照してください。
  • 5xx エラー:指数バックオフで再試行し、問題が続く場合はサポートにお問い合わせください。
最終更新日 2026年10月2日