Frequently asked questions

No. HopBase is directly accessible from mainland China without a proxy.

OpenAI protocols for GPT, Codex, and third-party clients include /v1. The Anthropic protocol for Claude Code and the Anthropic SDK does not; those clients append the API path themselves.

Select OpenAI Chat Completions (routing required), use https://api.hop-base.com/v1, and set the model to glm-5.3.

Use the OpenAI Images protocol: POST https://api.hop-base.com/v1/images/generations with model, prompt, and size. Gemini Banana and Seedream 5.0 Pro use the same client-side protocol, but image-to-image and asynchronous capabilities vary. Seedream supports synchronous generation and editing with up to 10 reference images. Add image to the generations JSON or use /v1/images/edits. See the Image API.

Yes. A key can include up to 10 groups across platforms: when creating a key under API Keys in the console, add a Codex Plus or Codex Pro group for GPT and a Claude Max group for Claude, or edit an existing key to add the missing group. Each request is billed by the group that serves its model. Call each model on its own protocol: GPT on the OpenAI-compatible endpoints, Claude on /v1/messages.

Yes. The console's one-click setup dialog provides a Windows PowerShell command. For manual setup, see the Windows PowerShell tab on the Claude Code and Codex CLI pages.

The command contains a single-use integration token that expires after 15 minutes, not the API key itself. The script only updates local configuration and backs up existing settings.

Yes. Usage from the same key is combined under one account. Separate named keys per device make usage easier to attribute.

Sign in to the console. Usage shows the model, token count, and charge for every request. From code, call GET https://api.hop-base.com/v1/usage with an API key to get the balance currently available to that key (already capped by the key's and your enterprise's quotas); the response fields are in Account and catalog API.

Sign in to the console, select Recharge in the menu, choose an amount, and follow the payment prompts. Before you pay, the page shows the amount to pay and the amount to be credited; the balance is credited automatically once payment succeeds. For other payment methods such as a company bank transfer, contact us.

Since 2026-10-01 your balance is in US dollars (USD): the console shows balances, charges, and usage records in $, and models are billed at the official US-dollar price multiplied by your group's rate. Balances from before the switch were converted to USD at a fixed rate, so what you can spend did not change. The cost returned by the API is the same charge in CNY; the USD amount is in cost_usd. See Balance currency. For top-ups, the payment currency, fees, and amount credited are the ones the Recharge page shows before you pay; for CNY company bank transfers and offline top-ups, the USD amount credited is confirmed by support.

Under section 4 of the Terms of Service, consumed credit and bonus credit such as promotions or rewards are not refunded in cash. For any other refund request, contact us with your account email and the order number from Recharge records.

For invoices or company billing, contact us with your account email, the order number from Recharge records, and your invoicing details.

This usually means the model is temporarily unavailable or the response timed out. Retry with backoff, or switch to another model in the same family. If it persists past 10 minutes, contact us with the X-Request-ID from the response headers. See Error codes and retries for the retry rules.

Read error.message (no code, not billed) and fix that before resubmitting. See Error codes and retries.

Direct browser connections are supported. Web clients often do not append an API path. For OpenAI, GPT, or GLM modes, enter the complete https://api.hop-base.com/v1 URL. For Anthropic mode and Claude, omit /v1.