はじめに

トークンの使い方

LLMs Text

トークンの利用

sk-4ai-... は 4AICode 中継へアクセスする唯一の認証情報であり、すべてのリクエストに含める必要があります。

トークンの作成

ダッシュボード → トークン管理 → 新規トークン に移動し、名前を入力して 作成 をクリックします。

⚠️ トークンは一度だけ表示されます。1Password や Bitwarden などのパスワードマネージャーにすぐにコピーしてください。ダイアログを閉じると復元できず、失効して新規作成するしかありません。チャットウィンドウに貼り付けたり、git にコミットしたりしないでください。

使い方

Authorization: Bearer ヘッダーを使用します。

Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx

URL クエリパラメータ(?api_key=...)や X-Api-Key ヘッダーは、HTTP ログに露出しやすいためサポートしていません。

チームの分離

トークンは作成されたチーム配下のリソースにのみアクセスできます。

  • チームを切り替える → 新しいトークンを作成
  • 利用料金は常にトークンを所有するチームに請求されます

すべてのチームにアクセスできる単一のトークンはありません。

トークンの失効

トークン管理 ページで 失効 をクリックします。失効は取り消せず、即座に有効になります。1 秒以内にすべてのリクエストは 401 を返します。失効後、同じ名前で新しいトークンを作成できます。

失効すべきタイミング

シナリオ失効?
公開リポジトリ、グループチャット、スクリーンショットに貼り付けた✅ 直ちに
退職した従業員の開発マシンに保存されている✅ 直ちに
定期ローテーション(90 日ごとを推奨)✅
ノート PC の買い替え❌ そのまま再利用
侵害の疑い✅ 先に失効

エラーコード

ステータスコード意味
401トークンが欠落、形式不正、または失効済み
403管理者によりチームが停止されている
429レート制限またはクォータ超過。詳細は レート制限 / クォータ を参照

FAQ

Q: トークンはいくつまで持てますか? A: ハード上限はありません。端末ごとに 1 トークンを使うことを推奨し、個別の端末のアクセスを失効させやすくします。

Q: 1 つのトークンで Claude と GPT-5 の両方を使えますか? A: はい。トークンはモデルではなくチームに紐づきます。