API Key 管理

キーの作成と管理

1. ユーザー一覧で対象ユーザーの 操作 列にある キー ボタンをクリック。
2. キー設定 パネルで確認・設定を行います：

設定項目の説明

項目	説明	例/操作
キー	システムが生成する sk- で始まる高強度ランダム文字列。	右側の コピー アイコンで複製。
説明	キー用途のメモ。監査に役立ちます。	例：Dev Environment CI/CD
有効期限	キーの有効期間。期限切れ後は拒否されます。	日時を選択。
有効状態	キーの有効化/凍結。	トグルを ON/OFF。

4. 保存 をクリックして適用。

検証とトラブルシューティング

設定完了後、ユーザーはこのキーで Cherry Studio API を利用できます。

• 成功の確認方法：キーで標準の Chat Completion リクエストを送信し、ストリーミング応答が返れば成功。
• よくあるエラー 401 Unauthorized または Key Expired：
  1. 有効期限 が過ぎていないか。
  2. 有効状態 がオフになっていないか。
  3. グループ に有効なモデルチャネルが設定されているか。

サードパーティクライアント、IDE プラグイン、自社サービスから Enterprise Express モデルを直接呼び出す場合は、外部アプリ接続（Express モデル） を参照してください。