GetAPIGetAPI.ONE
GetAPI.ONE クイックスタート
アカウント作成とモデル選択から、範囲を限定した API キー、クライアント設定、検証可能な最初の接続までの一連の手順です。
開始前に
- 公式ドメイン https://www.getapi.one と、認証に利用できるメールボックスを使用します。
- Codex CLI、元資料の CCSwitch 手順、自分の API クライアントのいずれを接続するか決めます。
- 非公開のパスワード管理ツールまたは環境変数の保管先を用意します。実際のキーを公開 issue、スクリーンショット、リポジトリに貼り付けてはいけません。
1. アカウントを作成して開く
- 登録ページを開き、ユーザー名、8–20 文字のパスワード、メールアドレスを入力します。
- メールの認証コードを要求して入力し、リンク先の利用規約とプライバシーポリシーを確認して同意し、アカウントを作成します。
- ユーザー名またはメールアドレスとパスワードでログインします。成功すると概要ページが開きます。
2. 残高、エンドポイント、モデルを確認
- 課金されるリクエストを送る前に、利用可能な残高または適用可能なパッケージがあることを確認します。
- モデルカタログを開き、クライアントが使うエンドポイントへの対応を明示したモデルを選びます。モデル名からプロトコル対応を推測しないでください。
- 利用直前に最新料金を開きます。モデルの提供状況と料金は変わるため、このガイドには料金を転記していません。
3. 範囲を限定した API キーを作成
- API キーを開いて作成を選び、クライアントやプロジェクトを識別できる名前を付けます。
- 必要なグループ、具体的な有効期限、連携に合う上限を選びます。必要なアクセスを理解した場合のみ、高度な制限の範囲を広げます。
- キーを保存し、キー一覧から非公開の保管先にコピーします。GetAPI.ONE では管理可能な一覧項目が残り、後からキーを再度コピーできます。
4. クライアントを 1 つ接続
クライアントに合った経路のみを使用します。Codex のカスタムプロバイダー設定は Responses wire API と ONE ベース URL https://www.getapi.one/v1 を使用します。直接 API を使うプログラムは、パスを無条件に追加せず、明示された個別のエンドポイントを使う必要があります。
5. 確認して次へ進む
- 選択したクライアントが有効な応答を受信し、GetAPI.ONE コンソールにリクエストが記録されれば成功です。ローカルの構文チェックだけでは実際の呼び出しの成功になりません。
- 401 では ONE キーをコピーし直し、有効であることと ONE のアドレスと組み合わせていることを確認します。404 では、クライアントが期待する正確なエンドポイントまたは /v1 ベースを確認します。
- モデルが見つからない場合は、キーのグループで利用でき、エンドポイントに対応するモデルを選びます。上限、レート、ネットワーク、上流エラーでは、診断前にタイムスタンプとリクエスト識別子を保存します。