GetAPIGetAPI.ONE API 入門：API キーの取得から初回リクエストまで
アカウントの作成とモデルの選択から、スコープ指定された API キー、クライアント構成、および動作する最初の接続までの完全なパス。
ここから始める
GetAPI.ONE を初めて使う場合は、アカウントを作成し、モデルと対応エンドポイントを選んでから API キーを作成します。キーがある場合は、以下の Python または Node.js の例に進めます。リクエストを送信する前に現在の料金を確認してください。
開始前に
- 公式ドメイン https://www.getapi.one と、認証に利用できるメールボックスを使用します。
- Codex CLI、CCSwitch を介した互換性のある Codex ターゲット、または独自の 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 ベースを確認します。
- モデルが見つからない場合は、キーのグループで利用でき、エンドポイントに対応するモデルを選びます。上限、レート、ネットワーク、上流エラーでは、診断前にタイムスタンプとリクエスト識別子を保存します。