GetAPI.ONE API リクエストを送信

前提条件と対応範囲

• GETAPI_ONE_API_KEY に保存された範囲限定の GetAPI.ONE キー。
• 呼び出すエンドポイント種別への対応を明示した、現在のカタログモデル。
• curl がインストールされ、www.getapi.one への HTTPS 通信が許可されたコマンドライン。
• 実際のリクエストには使用料金が発生し得ることを受け入れていること。例はモデルリクエストを送信せずに確認しました。

• キーを作成して読み込む
• エンドポイントに対応するモデルを選ぶ

1. 明示されたエンドポイントを選ぶ

他のプロトコル系統ではパスとリクエスト本文が異なります。選択したモデルのページに表示されたエンドポイントに従い、Anthropic、Gemini、画像、動画の呼び出しを上記 2 つの例に一律に変換しないでください。

2. Responses API の例

Responses エンドポイントが記載されたカタログモデルを選んでから使用してください。実行前に YOUR_RESPONSES_MODEL を置き換えます。

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Chat Completions の例

選択したカタログモデルに OpenAI Chat エンドポイントが記載されている場合のみ使用してください。実行前に YOUR_CHAT_MODEL を置き換えます。

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. 結果を確認

1. まず HTTP ステータスを読みます。2xx はゲートウェイが HTTP リクエストを受け付けて完了したことを示しますが、クライアントは応答オブジェクトに期待する出力があるかも確認する必要があります。
2. Responses では返された応答の status/output 構造を確認し、Chat Completions では choices 構造を確認します。別のプロトコルに同じ応答形式を想定しないでください。
3. GetAPI.ONE のリクエストログまたは使用ログを開き、時刻、エンドポイント、モデル、利用可能ならリクエスト識別子を照合します。

ストリーミングと再試行

ストリーミングは応答の転送とイベント処理を変えます。対応状況は選択したエンドポイントとモデル次第です。まず非ストリーミングのリクエストを使い、stream パラメーターを追加する前にプロトコル資料とモデルページを確認してください。

• 認証、上限、権限、モデル選択のエラーを自動再試行しないでください。
• タイムアウトや上流の障害を再試行する前に、元のリクエストが処理済みの可能性と、その操作を安全に繰り返せるかを確認してください。
• アプリケーションでは再試行回数を制限し、待機時間を設けます。診断のためにリクエスト識別子とタイムスタンプを保存してください。

エラー別の対処

• トラブルシューティング確認項目
• サポートへの報告を準備