接入文档

兼容 OpenAI 格式，填 Base URL 和 Key 就能用。

概览

接口兼容 OpenAI，工具里选 OpenAI Compatible 即可
建议开 stream，长回答不容易断
每笔请求的 token、费用、耗时都能在控制台看到

开始使用

买套餐 — 选一个套餐付款，到账自动生效
建 Key — 控制台新建 API Key，可以限额度、绑 IP
填进工具 — 把 Base URL 和 Key 填到你用的工具里

API Key 创建后只显示一次，记得马上存好。

Codex

需要修改 Codex 的两个本地配置文件：一个放接口配置，一个放 API Key。改完以后要完全重启 Codex。

1 config.toml

填写模型、Base URL 和接口类型。macOS 一般在 ~/.codex/config.toml。

2 auth.json

填写你的 API Key。macOS 一般在 ~/.codex/auth.json。

config.toml

model_provider = "gateway"
model = "gpt-5.2"
network_access = "enabled"
disable_response_storage = true

[model_providers.gateway]
name = "gateway"
base_url = "https://tk.hb.cn"
wire_api = "responses"
requires_openai_auth = true

auth.json

{
  "OPENAI_API_KEY": "sk-你的 API Key"
}

Cline / Roo Code / OpenClaw

选 OpenAI Compatible，填这几项：

Provider	`OpenAI Compatible`
Base URL	`https://tk.hb.cn`
API Key	控制台创建的 `sk-` 开头密钥
Model	从控制台「可用渠道」复制模型名
Stream	建议开启

直接调用

自己写代码的话，把 SDK 的 baseURL 换成你的地址。

bash

curl "https://tk.hb.cn/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的 API Key" \
  -d '{
    "model": "gpt-5.2",
    "input": "你好",
    "stream": true
  }'

接口路径

路径	用途	说明
`/v1/chat/completions`	聊天补全	兼容 OpenAI 格式工具
`/v1/responses`	Responses	Codex 等客户端用这个
`/v1/models`	模型列表	查当前 Key 可用的模型
`/v1/images/generations`	图像生成	取决于套餐配置

计费

扣费优先走套餐额度，用完走账户余额。

套餐额度 — 按周期重置，用完当期就停
账户余额 — 备用扣费来源，充多少用多少
Key 限制 — 单个 Key 可设额度上限、有效期、IP 白名单

模型

可用模型取决于后端渠道配置，控制台能看到完整列表。

报 model not found？回控制台复制模型名，别自己猜。

常见报错

状态码	原因	处理
`401`	Key 错误或无权限	检查 Authorization 头，或重新生成 Key
`404`	路径或模型名不对	确认 Base URL 和模型名
`429`	并发过高	降并发，加重试退避
`502/504`	响应超时	开 stream，避免长时间空闲
`5xx`	服务端异常	稍后重试或换模型

发截图给支持时，遮住完整 Key，只留前后几位。