一行 base_url，接入海量 AI 模型

三步开始使用

🎉 首充加赠 50%：首次充值额外赠送 50% 额度（仅限首充）。充值按 1 美元额度 = 实时美元汇率 折算人民币，汇率每日自动更新。

接口地址与鉴权

汇API 同时兼容 OpenAI 与 Anthropic 两套接口协议，统一入口如下：

鉴权方式

在请求头中携带你的密钥，三种写法任选其一，与各家官方 SDK 完全一致：

• OpenAI 式：Authorization: Bearer sk-…
• Anthropic 式：x-api-key: sk-…
• Gemini 式：x-goog-api-key: sk-…

常用端点

• /v1/chat/completions — OpenAI 对话补全（流式 / 非流式）
• /v1/messages — Anthropic 原生消息接口（Claude Code 直连）
• /v1/models — 模型列表
• /v1/images/generations — 图像生成

💡 大多数工具只需要填 base_url 和 密钥 两项。若工具要求填写的地址末尾已含 /v1，请勿重复添加。

模型与价格

价格为美元 / 百万 tokens，实时以后台配置为准。完整模型列表与官方价对比见 模型广场。

调用时 model 字段填写上表中的模型名即可。模型持续更新，具体以模型广场展示为准。

Claude Code推荐

汇API 原生支持 Anthropic 的 /v1/messages 接口，Claude Code 只需两个环境变量即可指向汇API，用 Claude 全系模型驱动。

方式一：环境变量（临时生效）

export ANTHROPIC_BASE_URL="https://api.huiapi.top"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

claude   # 正常启动，模型请求将经汇API转发

方式二：写入配置（长期生效）

把上面两行写进你的 ~/.bashrc / ~/.zshrc（Windows 用户写入 PowerShell 配置或系统环境变量），重开终端后即可直接使用。

若你此前登录过官方账号，请先执行 claude /logout 或清除旧的登录态，确保走的是环境变量里的汇API 地址。

Codex / ChatGPT

OpenAI 的 Codex CLI 通过配置文件 ~/.codex/config.toml 指定自定义服务商。将 provider 的 base_url 指向汇API 即可。

编辑 ~/.codex/config.toml

model = "gpt-5.5"
model_provider = "huiapi"

[model_providers.huiapi]
name = "huiAPI"
base_url = "https://api.huiapi.top/v1"
wire_api = "chat"

设置密钥

export OPENAI_API_KEY="sk-你的密钥"
codex

💡 若使用支持自定义 API 的 ChatGPT 第三方客户端，同样把服务地址填 https://api.huiapi.top/v1、密钥填你的 sk- 令牌即可。

LangChain / SDK

任何基于 OpenAI 或 Anthropic 官方 SDK 的框架（LangChain、LlamaIndex、自研程序等），都只需覆盖 base_url 与密钥。

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.huiapi.top/v1",
    api_key="sk-你的密钥",
    model="gpt-5.5",
)
print(llm.invoke("你好").content)

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.huiapi.top",
    api_key="sk-你的密钥",
)
msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role":"user","content":"你好"}],
)
print(msg.content[0].text)

OpenAI 格式调用

from openai import OpenAI

client = OpenAI(
    base_url="https://api.huiapi.top/v1",
    api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role":"user","content":"你好"}],
)
print(resp.choices[0].message.content)

curl https://api.huiapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'

Anthropic 格式调用

curl（/v1/messages）

curl https://api.huiapi.top/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"你好"}]
  }'

Cherry Studio

Cherry Studio 是一款支持多服务商的桌面 AI 客户端。添加汇API 作为自定义服务商：

1. 打开 设置 → 模型服务，点击底部「添加」，服务商类型选择 OpenAI（或 Anthropic）。
2. API 地址填 https://api.huiapi.top，API 密钥填你的 sk- 令牌。
3. 在「模型」中手动添加需要的模型名（如 gpt-5.5、claude-sonnet-5），保存后即可在对话中选用。

💡 Cherry Studio 会自动在地址后补 /v1，因此 API 地址填到域名即可，无需手动加 /v1。

Chatbox

Chatbox 是跨平台的轻量对话客户端。配置步骤：

1. 进入 设置，模型提供方选择 OpenAI API（或「添加自定义提供方」）。
2. API 域名 / Host填 https://api.huiapi.top，API 密钥填你的令牌。
3. 模型名填 gpt-5.5 等，保存即可开始对话。

Open WebUI

Open WebUI 通过 OpenAI 兼容连接接入汇API：

1. 进入 管理面板 → 设置 → 外部连接（OpenAI API）。
2. API 基础地址填 https://api.huiapi.top/v1，API 密钥填你的令牌。
3. 保存后刷新，模型列表会自动拉取，可在对话中直接选择。

💡 若通过 Docker 部署 Open WebUI，可用环境变量 OPENAI_API_BASE_URL=https://api.huiapi.top/v1 与 OPENAI_API_KEY=sk-… 预置。

CodeBuddy

CodeBuddy 等支持自定义模型服务的编程助手，通常在其设置中提供「自定义 / OpenAI 兼容」入口：

1. 在模型/服务设置中选择自定义或 OpenAI 兼容模式。
2. Base URL 填 https://api.huiapi.top/v1，密钥填你的令牌。
3. 模型名填写你要使用的模型（如 claude-sonnet-5）。

Trae

Trae 支持接入自定义模型服务商：

1. 进入模型设置，添加自定义模型 / OpenAI 兼容服务。
2. 服务地址填 https://api.huiapi.top/v1，密钥填你的令牌。
3. 填入模型名并保存，即可在编辑器内调用。

CC Switch

CC Switch 用于在多个 Claude Code 服务端之间快速切换。新增一个指向汇API 的配置：

1. 新增配置项，Base URL 填 https://api.huiapi.top。
2. Token / 密钥填你的 sk- 令牌。
3. 切换到该配置后，Claude Code 的请求即经汇API 转发。

💡 其原理与「Claude Code 环境变量」一节相同，只是由 CC Switch 帮你管理多套 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN。

Hermes / OpenClaw 403 代理

部分工具（如 Hermes、OpenClaw）在本机与上游之间有一层代理。若你遇到 403 之类的拦截，通常是请求头或地址未正确指向汇API。排查要点：

• 确认代理的上游地址已设为 https://api.huiapi.top（Anthropic 类工具）或 https://api.huiapi.top/v1（OpenAI 类工具）。
• 确认密钥透传正确，未被代理层改写或丢弃。
• 确认未叠加会篡改 Authorization / x-api-key 头的中间层。

⚠️ 若仍返回 403，请携带请求示例联系客服，我们协助定位。

充值与支付

登录控制台，进入 钱包 / 充值 页面，选择金额后使用微信或支付宝完成支付，额度实时到账。

• 计价：以美元额度计费，充值时按当日实时美元汇率折算人民币，汇率每日自动更新。
• 首充加赠：首次充值额外赠送 50% 额度（仅限首充）。
• 注册礼：邮箱验证注册即送 $3 体验额度。

💡 额度按实际用量（tokens）扣费，用多少扣多少，余额不清零。

用量与日志

登录 控制台，可查看：

• 调用日志：每一次请求的模型、时间、输入/输出 tokens 与费用明细。
• 令牌管理：创建 / 停用密钥，为不同用途设置额度上限。
• 余额与账单：实时余额、消费统计。

常见问题

和直接用官方 API 有什么区别？

接口完全兼容，模型为官方原版、不降智。你无需分别订阅各家、无需海外网络，一个账号一个密钥即可调用全部模型，价格通常更低。

支持流式（SSE）吗？

支持。请求中带 "stream": true 即可，行为与官方一致。

一个密钥能同时用于多个工具吗？

可以。同一个 sk- 密钥可用于 Claude Code、Cherry Studio、自研程序等任意兼容工具，用量合并计费。

如何选择用 OpenAI 地址还是 Anthropic 地址？

取决于工具：OpenAI 类工具（Chatbox、Open WebUI、Codex 等）用 /v1 地址；Claude Code、CC Switch 等 Anthropic 类工具用域名根地址并走 /v1/messages。

如何查看用量和账单？

登录 控制台 即可查看每次请求的用量、耗时与费用明细。

故障排查

仍未解决？携带请求示例与报错信息，通过站内「联系客服」联系我们。

服务条款

使用汇API 即表示你同意：仅将服务用于合法合规用途；不得利用本服务从事违反相关法律法规或上游服务商政策的活动；因违规使用导致的后果由使用者自行承担。我们保留在必要时调整价格、模型可用性与服务规则的权利，重大变更将提前公示。

完整条款以控制台内公示版本为准。

隐私政策

我们仅收集为提供服务所必需的信息（如账户邮箱、调用日志用于计费与排障）。我们不会出售你的个人信息；请求内容仅用于转发至对应模型上游以完成调用。请妥善保管你的密钥，避免泄露。

完整政策以控制台内公示版本为准。