常见问题

不需要。HopBase 在国内可直接访问，无需任何代理。

OpenAI 协议（GPT、Codex、第三方客户端）带 /v1；Anthropic 协议（Claude Code、Anthropic SDK）不带，客户端会自动补全。

选择 OpenAI Chat Completions（需开启路由），Base URL 填 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 系列也走同一协议结构；各模型的图生图与异步能力不同。Seedream 支持同步文生图及最多 10 张参考图的图生图 / 编辑：在 generations JSON 加 image，或使用 /v1/images/edits，请参见图片生成 API。

可以。一把密钥最多可包含 10 个分组，可以跨平台：在控制台「API 密钥」创建密钥时同时选上 Codex Plus 或 Codex Pro 分组与 Claude Max 分组，或编辑已有密钥补上缺的分组。每次请求按服务该模型的分组计费。各模型仍走自己的协议：GPT 用 OpenAI 兼容端点，Claude 用 /v1/messages。

完全可以。推荐走控制台「一键接入」（弹窗里切到 Windows PowerShell 命令）；手动配置见 Claude Code 与 Codex 两节的 Windows PowerShell 分页。

命令里带的是 15 分钟内有效、只能使用一次的接入令牌，不是密钥本身；脚本只写本机配置文件，原有配置会自动备份。

可以，同一把密钥可在多设备使用，用量合并计入同一账户。建议给不同设备各建一把并命名，方便在用量里区分。

登录控制台，「使用记录」里可以看每一笔调用的模型、token 数和扣费。程序里用 API 密钥调 GET https://api.hop-base.com/v1/usage，可查这把密钥当前可用的余额（已按密钥额度与企业额度取小），返回字段见账户 API。

登录控制台，在菜单中点「充值」，选好金额后按页面提示付款；付款前页面会列出实付金额与到账金额，付款成功后余额自动入账。需要对公转账等其他付款方式，联系我们。

自 2026-10-01 起，余额以美元（USD）计价：控制台的余额、扣费与使用记录都以 $ 显示，模型按官方美元价乘以分组倍率计费。切换前的余额已按固定比例换算为美元，可用量不变。接口返回的 cost 是同一笔扣费的人民币金额，美元金额看 cost_usd，见余额与计价币种。充值时付款币种、手续费与到账金额以「充值」页付款前显示的为准；人民币对公转账或线下充值的到账美元金额以客服确认为准。

按服务条款第 4 节：已消耗的额度，以及促销、奖励等赠送额度，不按现金退还。其他退款需求请带上账户邮箱与「充值记录」里的订单号，联系我们。

需要发票或对公结算时，请带上账户邮箱、「充值记录」里的订单号与开票信息，联系我们。

通常是该模型暂时不可用或响应超时：稍等后退避重试，也可以换同系列的其他模型。持续超过 10 分钟，请带上响应头里的 X-Request-ID 联系我们。重试规则见错误码与重试。

看 error.message（无 code，不扣费），改好再提交。见错误码与重试。

已支持浏览器直连。使用 OpenAI / GPT / GLM 模式时，网页版通常不会自动补 API 路径，Base URL 必须手动填完整的 https://api.hop-base.com/v1；只填 https://api.hop-base.com 会连不上。Claude 的 Anthropic 模式依上文规则不带 /v1。