このガイドで分かること
OpenAI organization で Admin API Key を作成し、HIHARUに設定して接続確認するまでの流れです。
最短セットアップ（4ステップ）
- OpenAI Platformで対象organizationを選択。
- People で自分が Owner か確認。
- Admin keys で Admin key を新規作成。
- HIHARUのOpenAI欄にキーを貼り付けて「接続確認」。
用語解説
| 用語 | 意味 |
|---|---|
| Organization | ユーザーとプロジェクト、キーを束ねる単位。 |
| Owner | 組織設定や管理系キー作成ができる権限。 |
| Admin API Key | 組織管理系APIに使うキー。Usage取得に必要。 |
Scope api.usage.read |
使用量参照のための必須スコープ。 |
エラー別チェック
| 表示エラー | 原因 | 対応 |
|---|---|---|
Missing scopes: api.usage.read |
スコープ不足 | 管理画面でキー権限を見直し、必要スコープ付きで再作成 |
insufficient permissions |
Owner権限不足 | organizationのOwnerに権限付与を依頼 |
The selected AIモデル is invalid. |
利用不可モデルを選択 | 利用可能モデルへ変更して再保存 |