GetAPIGetAPI.ONE
GetAPI.ONE API キーの作成と保護
名前と範囲を指定したキーを作成し、グループ、有効期限、上限を選び、ソースコードの外に保存して動作を確認し、安全に失効させます。
前提条件
- GetAPI.ONE にログインし、コンソールを開けることを確認します。
- アカウントに利用可能な残高または適用可能なパッケージがあることを確認します。
- このキーを使用する単一のクライアントまたはプロジェクトと、秘密の環境変数の保存先を決めます。
キーを作成
- コンソールのナビゲーションから API キーを開き、API キーの作成を選びます。
- クライアントや環境など、用途が分かる名前を入力します。シークレット自体を名前に含めないでください。
- 目的のモデルとエンドポイントに必要なグループを選びます。
- キーを 1 つ、具体的な有効期限、想定利用に合った上限を設定します。高度な制限はクライアントで必要な場合にのみ確認してください。
- 変更を保存してキー一覧に戻ります。
コピーして保存
作成後の一覧には、キー名、マスクされたキー、グループ、状態、管理操作が表示されます。GetAPI.ONE のキーは一度限りの表示ではありません。キー一覧から再度コピーし、引き続き管理できます。
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"キーと ONE のアドレスを組み合わせる
| 用途 | 値 |
|---|---|
| サイト / API オリジン | https://www.getapi.one |
| Codex / CCSwitch のベース URL | https://www.getapi.one/v1 |
| 認証情報 | GetAPI.ONE のキー一覧からコピー |
キーを露出させずに確認
- クライアントを 1 つ設定するか、直接リクエストのガイドでモデルのプレースホルダーを対応エンドポイントのカタログ項目に置き換えます。
- 課金を受け入れられる最小限のリクエストのみを送信してください。このガイドの制作中にリクエストは送信していません。
- 有効な応答を確認し、コンソールのリクエスト記録または使用記録を調べます。診断出力を保存する前にキーを隠してください。
エラー、キーの更新、失効
- 401 / Unauthorized：キーをコピーし直し、余分な空白を除去し、有効であることと ONE のアドレスと組み合わせていることを確認します。
- モデルが見つからない、またはアクセスが拒否される場合：キーのグループでモデルにアクセスでき、モデルがクライアントで使うエンドポイントに対応すると明示していることを確認します。
- 上限または有効期限のエラー：設定を広げる前にキーの上限と有効期限を調べ、アカウント残高とレート制限も確認してください。
- 漏洩が疑われる場合：対象キーを無効化または削除し、必要最小限の範囲で代替キーを作成し、クライアントを更新して、古いキーが使用できないことを確認します。