sub2api 是独立的倍率 API 网关（按官方美金价倍率计费），与 coder 网关分开计费、各用各的 API Key。本页介绍如何调用 sub2api。
一个 API Key，三套协议
sub2api 对外提供同一个 Base URL，同时兼容 OpenAI、Anthropic、Google Gemini 三套官方 API 协议。客户端不用换 SDK，只把官方 SDK 的 Base URL 改成 sub2api 即可。
| 协议族 | 路径前缀 | 典型客户端 |
|---|
| OpenAI 兼容 | /v1 | OpenAI SDK、Codex CLI、OpenCode |
| Anthropic 兼容 | /v1 | Anthropic SDK、Claude Code |
| Gemini 兼容 | /v1beta | Gemini CLI、@google/generative-ai |
服务地址
https://sub2api.visioncoder.cn
GET /v1/models 也需鉴权）。
Bearer Token（推荐）
x-api-key（Anthropic）
适用于 OpenAI / Codex / OpenCode 等客户端。Authorization: Bearer YOUR_API_KEY
Claude Code 等 Anthropic SDK 客户端使用此请求头。 计费方式
sub2api 按模型官方美金价 × 倍率透明计费，起步倍率 2x，按量结算、不锁并发。倍率套餐与余额在 充值套餐 页面查看与购买。
可用模型
聚合 Claude、GPT、Gemini 等主流大模型。最新列表以 GET /v1/models 实时返回为准（需携带 API Key）。
curl https://sub2api.visioncoder.cn/v1/models \
-H "Authorization: Bearer $SUB2API_KEY"
调用示例
curl https://sub2api.visioncoder.cn/v1/chat/completions \
-H "Authorization: Bearer $SUB2API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "user", "content": "Hello"}
],
"stream": false
}'
模型 ID 用 GET /v1/models 返回的值。上例中的 gpt-5.4 仅为占位，请替换为列表中真实存在的模型。
Claude Code 接入
把环境变量指向 sub2api，即可用 sub2api 的额度跑 Claude Code：
export ANTHROPIC_BASE_URL="https://sub2api.visioncoder.cn"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
claude
端点总览
| 方法 & 路径 | 说明 |
|---|
GET /v1/models | 返回可用模型（需鉴权） |
POST /v1/chat/completions | OpenAI Chat Completions 兼容 |
POST /v1/responses | OpenAI Responses 协议 |
POST /v1/messages | Anthropic Messages 兼容 |
POST /v1beta/models/{model}:generateContent | Gemini generateContent 兼容 |
POST /v1/images/generations | 图像生成 |
错误返回
错误以 HTTP 状态码 + JSON Body 形式返回，结构为 code + message：
{
"code": "INVALID_API_KEY",
"message": "Invalid API key"
}
| 状态码 | 含义 | 处理建议 |
|---|
| 401 | API Key 无效 | 在 API Key 管理 重建 |
| 402 | 余额不足 | 去 充值套餐 |
| 429 | 触发限速 | 降低并发或升级套餐 |
| 5xx | 上游错误 | 稍后重试，持续失败请反馈 |
加群 & 客服
