クイックスタート

Anthropic の Base URL には /v1 を含めません(API パスは Anthropic クライアントが自動的に付加します)。OpenAI の Base URL には /v1 を必ず含めてください。

接続手順

手順は 3 つです。アカウントを登録し、キーを作成し、Base URL とキーをツールやコードに設定します。

最初のリクエストを送る

まず、現在のキーで呼び出せるモデルの一覧を取得します。

curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

続いて、最小構成のチャットリクエストを送ります。curl・Python・Node.js・Go・Java の各タブは OpenAI プロトコルで gpt-5.6-sol を呼び出し、Codex グループのキーが必要です。Claude タブは Anthropic プロトコルで claude-sonnet-5 を呼び出し、Claude グループのキーが必要です。別のモデルファミリーを使う場合は、model をそのキーで /v1/models が返す ID に置き換えてください。

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "ok とだけ返してください"}]
  }'

成功すると HTTP 200 が返ります。OpenAI プロトコルでは応答が choices[0].message.content に、Anthropic プロトコルでは content[0].text に入り、どちらにも usage オブジェクトが含まれます。

{
  "object": "chat.completion",
  "model": "gpt-5.6-sol",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "ok" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 2, "total_tokens": 14 }
}

401 はキーが正しくないことを示します。グループがそのモデルに対応していない旨の 404 は、キーのどのグループもそのモデルを提供していないことを示します。/v1/models にある ID を使うか、対応するグループをキーに追加してください。

コーディングエージェントにプロジェクトの変更を任せる場合は、AI と連携するに進んでください。

残高と課金

• 前払い制:コンソールのサイドバーのチャージからアカウントに入金します。呼び出しは実際の利用量に応じて残高から差し引かれます。残高がなくなると、新しいリクエストは 402 を返します。
• 単価:サインイン後のモデル一覧が正となります。各請求の明細はコンソールの使用履歴で確認できます。
• 失敗したリクエストは課金されません:失敗したリクエストは原則として課金されません。ストリームが途中で切れた場合は、すでに生成された分のみ課金されます。詳しいルールは同時実行数、タイムアウト、課金を参照してください。

グループの選び方

呼び出したいモデルに応じてグループを選んでください。1 つのキーには1〜10 個のグループを含められ、各リクエストはそのモデルを処理するグループの料率で課金されます。キーのダイアログには現在販売中のグループのみが表示され、モデルが重複するグループは組み合わせられません(GPT 公式ダイレクト(Azure)と Codex グループ・GPT Image 全モデルの併用は例外です。GPT の表の後の説明を参照)。サブスクリプション型のグループは単独でキーにする必要があります。実際の適用レートはアカウントによって異なり、サインイン後のモデル一覧が正となります。下表はどのグループがどのモデルに対応しているかのみを示します。グループ名はコンソールの日本語表示に合わせています。

Claude Code と Claude API

チャットとコーディング(OpenAI プロトコル)

Azure と Codex・GPT Image の併用:1 つのキーに GPT 公式ダイレクト(Azure)と、Codex Plus または Codex Pro のどちらか一方を同時に含められ、さらに GPT Image 全モデルも追加できます。利用元を指定する必要はありません。

• 両方のグループにあるモデルは、選択した順序に関係なく Azure グループが優先されます。Codex グループと重複するのは gpt-5.5、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-6-sol、gpt-6-luna、gpt-6-astra、gpt-6.1-sol、GPT Image 全モデルと重複するのは gpt-image-2.5-flare、gpt-image-2.5-sunburst です。Azure が何も出力しないうちに失敗した場合は、自動でもう一方のグループに切り替わります。出力が始まった後に途切れた場合は切り替わりません。
• 実際にリクエストを処理したグループで課金され、利用記録にもそのグループが表示されます。
• 一方のグループにしかないモデルは、通常どおりそのグループが処理します(例:codex-* は Codex グループのみ、gpt-5.4 と gpt-4.1 は Azure グループのみ、gpt-image-2 は GPT Image 全モデルのみ)。
• Azure グループで処理されるリクエストは Fast(priority)ティアに対応しておらず、標準ティアとして処理・課金されます。
• キーの作成ダイアログ、キー一覧、接続ダイアログでは、この 2 つのグループに「優先」「予備」が表示され、課金についての一文も添えられます。

Codex Plus と Codex Pro など、その他のモデルが重複するグループは引き続き同じキーに入れられません。

画像生成

Gemini Banana の画像生成は上記 2 つの Gemini グループに、Grok の画像生成は「Grok スイート」に、Kling の画像生成は下の「Kling 公式」に含まれます。

動画生成

音声

次のステップ

• OpenAI SDK、Anthropic SDK、curl — チャット、ストリーミング、ツール呼び出しの完全な例
• 利用可能なモデル — 各モデルの ID と機能
• 同時実行数、タイムアウト、課金 — 同時実行数の上限、タイムアウト、課金ルール
• エラーコードと再試行 — 各エラーコードの意味と再試行すべきかどうか