快速开始

Anthropic 协议地址不带 /v1，客户端会自动补全；OpenAI 协议地址必须带 /v1。

接入步骤

三步接入：注册账号，创建密钥，把 Base URL 和密钥填进你的工具或代码。

发送第一个请求

先用当前密钥读取模型列表，确认它能调哪些模型：

curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

再发一个最小对话请求。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-你的密钥" \
  -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~10 个分组，每个请求按服务该模型的分组的价格计费。密钥弹窗只展示当前在售的分组，模型有重叠的分组不能同时选（「GPT 官方直连(Azure)」与 Codex 分组、「GPT Image 全系」混用除外，见下方 GPT 表格后的说明）；订阅类分组只能单独成一把密钥。具体结算价格以登录后的模型广场为准，下表只说明每个分组能调用哪些模型。

Claude Code 与 Claude API

对话与编程（OpenAI 协议）

Azure 与 Codex、GPT Image 混用：一把密钥可以同时选「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）档，按标准档处理、按标准价计费。
• 建密钥弹窗、密钥列表和接入弹窗会在这两个分组上标「优先」「备用」，并附一句计费说明。

Codex Plus 与 Codex Pro 等其他模型重叠的分组，仍不能放进同一把密钥。

图片生成

Gemini Banana 生图在上面的两个 Gemini 分组里，Grok 生图在「Grok 全系」里，可灵生图在下面的「可灵模型分组（官方）」里。

视频生成

语音

下一步

• OpenAI SDK、Anthropic SDK、curl——完整的对话、流式与工具调用示例
• 可用模型——各模型的 ID 与能力
• 并发、超时与计费——并发上限、超时和计费规则
• 错误码与重试——每个错误码的含义和该不该重试