プラットフォーム API の認証

プラットフォーム API のリクエストは、マネジメントキーを Bearer トークンとして送信して認証します。

Authorization: Bearer rat_your_management_key

例：

curl https://www.routeapi.ai/api/open/v1/balance \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

マネジメントキー（Management Key）

マネジメントキーはプラットフォーム API（/api/open/v1）用の認証情報で、rat_ で始まります。モデルの呼び出しに使う sk- API Key とは別の認証情報です。

認証情報	プレフィックス	用途
マネジメントキー	`rat_`	`/api/open/v1` を呼び出してアカウントと API Key を管理
API Key	`sk-`	モデルエンドポイント（`/v1/chat/completions` など）を呼び出す。Chat Completions を参照

マネジメントキーが操作できるのは所有ユーザー自身のリソースのみです。管理者権限は継承されず、プラットフォーム API からマネジメントキー自体を管理することもできません。

RouteAPI コンソールにログインします。
サイドバーの Management Keys（Billing と Playground の間）を開くか、console/management-keys に直接アクセスします。
名前を入力し、有効期限を選択してキーを作成します。
rat_ で始まる平文キーをすぐにコピーして保存します。

各ユーザーが保持できるマネジメントキーは最大 10 個です。期限切れのキーも一覧に残り、引き続き上限にカウントされます。削除すると枠が空きます。キーが漏洩した場合は、同じページで削除してください。削除は即時に反映されます。

新しく作成したマネジメントキーは削除のみ可能で、失効や再有効化はできません。キーを無効化する唯一の方法は削除で、削除済みのキーを使ったリクエストは 401 invalid_token で失敗します。

マネジメントキーはシークレットマネージャーや CI のシークレットに保存し、ソースコードやコミットされる設定ファイルには置かないでください。
スクリプトやサービスごとに個別のマネジメントキーを作成すると、1 つを削除しても他に影響しません。
有効期限を設定してください。不要になったキーは期限切れを待たずに削除してください。
キーは実際にアカウントを管理するシステムにのみ渡してください。モデルを呼び出すアプリケーションに必要なのは sk- API Key であり、このキーではありません。
マネジメントキーの一覧を定期的に見直し、覚えのないキーは削除してください。

2 つの認証情報に互換性はなく、それぞれの API はもう一方のキーを 401 で拒否します。

リクエスト	結果
`sk-` API Key を `/api/open/v1` に送信	`401` `invalid_token` — このパスはマネジメントキーを要求します
`rat_` マネジメントキーを `/v1/chat/completions` などのモデルエンドポイントに送信	`401` 認証エラー — このパスは API Key を要求します

キーが有効に見えるのにいずれかの API が 401 を返す場合は、どのページで作成したキーか、どのプレフィックスかを確認してください。

エラーコードとレート制限はエラーと制限を参照してください。