よくある質問
HopBase の連携、キー、プロトコル、モデル、クライアントに関するよくある質問です。
いいえ。HopBase は中国本土からもプロキシなしで直接アクセスできます。
GPT、Codex、サードパーティクライアント向けの OpenAI プロトコルには /v1 が必要です。Claude Code や Anthropic SDK 向けの Anthropic プロトコルには不要です。これらのクライアントは API パスを自動的に付加します。
OpenAI Chat Completions (routing required) を選択し、https://api.hop-base.com/v1 を使用して、モデルに glm-5.3 を設定してください。
OpenAI Images プロトコルを使用します:POST https://api.hop-base.com/v1/images/generations に model、prompt、size を渡します。Gemini Banana と Seedream 5.0 Pro はクライアント側では同じプロトコルを使用しますが、画像から画像への変換や非同期対応の可否はモデルによって異なります。Seedream は同期での生成・編集に対応しており、参照画像は最大 10 枚まで指定できます。generations の JSON に image を追加するか、/v1/images/edits を使用してください。詳細は画像生成 APIを参照してください。
はい。1 つのキーにはプラットフォームをまたいで最大 10 個のグループを含められます。コンソールのAPIキーでキーを作成する際に GPT 用の Codex Plus または Codex Pro グループと Claude 用の Claude Max グループを追加するか、既存のキーを編集して足りないグループを追加してください。各リクエストはそのモデルを処理するグループで課金されます。各モデルはそれぞれのプロトコルで呼び出してください:GPT は OpenAI 互換エンドポイント、Claude は /v1/messages です。
はい。コンソールのワンクリック接続ダイアログには、Windows PowerShell 用のコマンドが用意されています。手動設定は Claude Code と Codex CLI の各ページにある Windows PowerShell タブを参照してください。
コマンドに含まれているのは、15 分で失効する使い捨ての接続トークンであり、API キー自体ではありません。スクリプトはローカルの設定を更新するだけで、既存の設定は自動的にバックアップされます。
はい。同じキーの利用状況は 1 つのアカウントにまとめて集計されます。デバイスごとに名前を付けた別々のキーを使うと、利用状況をデバイス単位で把握しやすくなります。
コンソールにサインインしてください。使用履歴で、リクエストごとのモデル、トークン数、課金額を確認できます。プログラムからは API キーで GET https://api.hop-base.com/v1/usage を呼び出すと、そのキーで現在利用できる残高(キーと企業のクォータで上限を適用済み)を取得できます。レスポンスのフィールドはアカウント・カタログ APIを参照してください。
2026-10-01 から残高は米ドル(USD)建てです。コンソールの残高、課金額、使用履歴はすべて $ で表示され、モデルは公式の米ドル価格にグループの倍率を掛けて課金されます。切り替え前の残高は固定の比率で米ドルに換算済みで、使える量は変わりません。API が返す cost は同じ課金額の人民元額で、米ドル額は cost_usd です。残高と課金の通貨を参照してください。チャージ時の支払通貨、手数料、入金額は、支払い前にチャージページに表示される内容が正となります。人民元での法人振込やオフラインのチャージで入金される米ドル額は、サポートの確認内容が正となります。
請求書や法人向けの精算が必要な場合は、アカウントのメールアドレス、チャージ履歴の注文番号、宛名などの発行情報を添えてお問い合わせください。
多くの場合、モデルが一時的に利用できないか、応答がタイムアウトしています。バックオフを挟んで再試行するか、同系列の別モデルに切り替えてください。10 分以上続く場合は、レスポンスヘッダーの X-Request-ID を添えてお問い合わせください。再試行のルールはエラーコードと再試行を参照してください。
error.message を確認し(code なし、課金なし)、直してから再送信してください。エラーコードと再試行を参照してください。
ブラウザからの直接接続に対応しています。Web クライアントの多くは API パスを自動的に付加しません。OpenAI、GPT、GLM モードでは、https://api.hop-base.com/v1 を省略せずに入力してください。Anthropic モードおよび Claude では /v1 を付けないでください。
次のステップ
- トラブルシューティング: エラーメッセージから対処法を探す
- 同時実行数、タイムアウト、課金: 同時実行数の上限と課金の仕組み
- アカウント・カタログ API: API キーで利用可能な残高を確認する