懂api· GatewayAI API 中转站
登录注册
接入参考资料。模型、计费、智能路由及生成能力以本站实际配置为准。

CLIENT INTEGRATIONS

把 懂api 接入你正在用的工具

先判断客户端使用 OpenAI 兼容协议还是 Anthropic Messages 协议，再填写 Key、Base URL 和实时模型 ID。

最后更新：

选择客户端

先确定端点规则

客户端协议填写的 Base URL客户端最终请求
OpenAI Compatiblehttp://localhost:3000/v1 /v1/chat/completions 或 /v1/responses
Anthropic / Claudehttp://localhost:3000/v1/messages
长任务或生成任务http://localhost:3000/v1对应的 OpenAI 兼容资源路径
同一个 Key 可以用于多种协议

差异在 URL 拼接方式。遇到 404 时先检查客户端是否已经自动追加 /v1 或完整资源路径。

选择客户端

RECOMMENDED IMPORT

CC Switch 一键导入

适合已经支持 CCS 导入的工具，包括 Claude Code、Cursor、OpenClaw 与 Hermes。控制台会把端点、Key 和模型选择交给 CC Switch 写入，减少手工录入错误。

COMPATIBLE ENDPOINT
由导入配置决定
REQUIRED INPUT
令牌、应用类型、模型
SUCCESS SIGNAL
导入成功并完成 200 请求
  1. 从 CC Switch Releases 安装最新版。
  2. 进入 令牌管理，在目标令牌上选择“CCS 导入”。
  3. 选择应用类型和模型。模型 ID 以模型广场当前展示为准。
  4. 允许浏览器打开 CC Switch，核对脱敏 Key 与端点后确认导入。
测试与成功信号

在目标工具发送“只回复 ok”。收到响应后，控制台使用日志应出现状态码 200 的同一模型请求。

导入时会一并开启 CC Switch 的余额查询（每 5 分钟刷新）。显示的剩余金额是这把 Key 还能用的钱：不限额度的 Key 即账户余额；设了额度的 Key 取它的剩余额度与账户余额中较小的一个。已用金额是这把 Key 自己的消费。其他工具也可以用同一把 Key 调用 GET http://localhost:3000/v1/dashboard/billing/credit_grants 查询，返回的 total_available 即剩余金额，单位为人民币。

Hermes 配置要点

Hermes 使用 OpenAI Compatible 时，Base URL 填 http://localhost:3000/v1，并固定使用 chat_completions。如果当前配置的 model.provider 是自定义名称，请改成 custom:你的供应商名称，否则 GPT-5 系列可能被 Hermes 自动切到 Responses 模式。 

model:
  default: YOUR_MODEL_ID
  provider: custom:ccapi

custom_providers:
  - name: ccapi
    base_url: http://localhost:3000/v1
    api_key: sk-你的令牌
    api_mode: chat_completions
    model: YOUR_MODEL_ID

导入按钮无反应时，检查是否安装了完整版本，并允许浏览器打开 ccswitch:// 协议。仍失败时改用对应客户端的手动配置。