sub2api 文档中心

本页用于给你的客户直接接入 sub2api。文档默认假设使用 OpenAI 兼容协议，并统一通过 https://sub.041714.xyz/v1 调用。

Base URL https://sub.041714.xyz/v1

鉴权 Authorization: Bearer sk-...

更新时间 2026-05-11 (Asia/Hong_Kong)

2. 购买与兑换卡密

发卡网购买到的是兑换码/卡密，需要先到 sub2api 控制台的“兑换”页面兑换。兑换成功后，账号会获得对应的余额、订阅或并发权益，然后再去中转站创建 API Key 接入客户端。

01

发卡网购买

打开购买入口，选择需要的套餐或商品，填写邮箱或联系方式后完成支付。

打开 pay.041714.xyz

02

复制兑换码

在订单结果页或邮箱里找到卡密。完整复制兑换码，注意兑换码区分大小写，不要多复制空格。

03

进入兑换页面

登录 sub2api 控制台，找到“兑换”页面，在“兑换码”输入框粘贴卡密，然后点击“兑换”。

04

创建 API Key

兑换成功后确认余额或订阅已更新，再进入中转站的 API Key 页面创建 sk-...，填入各客户端。

客户提示

兑换码只能使用一次，兑换后会绑定到当前账号。
兑换码不是 API Key，不能直接填到 Claude Code、OpenCode、OpenClaw 或 CC Switch。
客户端里真正要填写的是在中转站创建出来的 sk-... API Key。

3. 快速开始

先从发卡网购买兑换码/卡密。
登录 sub2api 控制台，进入“兑换”页面，粘贴兑换码并点击“兑换”。
确认账号余额或订阅已更新后，去中转站创建 sk-... API Key，并放到环境变量 OPENAI_API_KEY。
固定 Base URL：https://sub.041714.xyz/v1。
先调聊天接口验证连通，再进入业务接入。

curl 测试命令

curl https://sub.041714.xyz/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-5.5",
    "messages":[{"role":"user","content":"你好"}]
  }'

4. 鉴权与请求规范

请求头要求

Authorization: Bearer sk-...
Content-Type: application/json

路径规范

Base URL 含 /v1
接口路径不重复写 /v1
推荐先调 GET /v1/models

5. API 示例

聊天

POST /chat/completions

{
  "model": "gpt-5.5",
  "messages": [{ "role": "user", "content": "你好" }]
}

文生图

POST /images/generations

{
  "model": "gpt-image-2",
  "prompt": "一张科技感海报",
  "size": "1024x1024"
}

向量

POST /embeddings

{
  "model": "text-embedding-3-small",
  "input": "这是一段需要向量化的文本"
}

模型列表

GET /models

curl https://sub.041714.xyz/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

6. 支持模型（8）

以下来自 GET /v1/models 实时返回，最终以接口返回为准。

gpt-5.2 gpt-5.5 gpt-5.4 gpt-5.4-mini gpt-5.3-codex gpt-image-1 gpt-image-1.5 gpt-image-2

7. 客户端接入

需要完整图文步骤（含 OpenCode / OpenClaw / Full URL Mode）请查看 CC Switch 操作指南。

Claude Code

不能直接对接 OpenAI 兼容接口
需中间网关做协议转换（Anthropic Messages）
常用变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN

OpenCode

在 opencode.json 新增 provider
baseURL = https://sub.041714.xyz/v1
apiKey = {env:OPENAI_API_KEY}

OpenClaw

在 models.providers 增加 sub2api
baseUrl = https://sub.041714.xyz/v1
校验：openclaw config validate

CC Switch

新增 OpenAI-compatible 供应商
baseURL = https://sub.041714.xyz/v1
apiKey = OPENAI_API_KEY

9. 常见问题

401

Key 错误或 Bearer 格式错误。

404

路径错误，重点检查是否遗漏或重复 /v1。

429

触发频率/额度限制，建议增加重试与退避。

5xx

服务端临时异常，建议稍后重试并记录请求信息。

10. 交付检查清单

客户已经在发卡网购买兑换码/卡密，并在 sub2api 控制台完成兑换。
客户账号余额、订阅或并发权益已经更新。
客户已经在中转站创建独立 API Key。
客户本地已配置 OPENAI_API_KEY。
Base URL 明确为 https://sub.041714.xyz/v1。
已成功调用 /chat/completions。
已成功调用 /models 并看见目标模型。
客户端接入文档与实际工具版本一致。

11. 资料海报

统一接入、统一鉴权、统一模型调用