sub2api 文档中心

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

文档补齐：福利、日卡额度、推理强度已同步

福利活动包含：3 刀试用、售后群 1105301889、每日随机不限量日卡、发卡网购买与兑换流程。
日卡额度：为保障整体稳定性，日卡每天最高 400 刀额度，以后台和公告实际展示为准。
推理强度：支持 low、medium、high、xhigh 四档；不支持的模型请删除 reasoning_effort 参数。

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 刀试用，先体验模型效果和接口稳定性，再按需购买正式套餐。

售后群福利

进入售后群后，每天会随机赠送 不限量日卡。日卡用户使用时请注意选择订阅分组。

售后 QQ 群

售后群：1105301889。遇到兑换、余额、分组、接口调用等问题，可以进群咨询。

余额充值

余额充值和套餐购买请通过发卡网完成，购买后使用卡密到 sub2api 控制台兑换。

打开发卡网

日卡用户提示

日卡用户需要使用对应的 订阅分组，否则可能无法享受日卡权益或出现调用失败。

日卡额度限制

为避免滥用，同时保障中转站整体稳定性，日卡将限制每天最高 400 刀额度。请合理安排使用，避免短时间高强度调用影响账号体验。

生图模型福利

已支持生图模型，使用 生图 分组并选择 gpt-image-2 即可调用。参考价格：1K $0.0804/次，2K $0.1206/次，4K $0.1608/次。

领取前确认

先确认账号已经完成注册和登录。
通过发卡网购买的卡密，需要在 sub2api 控制台“兑换”页面兑换。
福利、日卡和生图能力可能依赖账号分组，请按公告选择对应分组。
活动内容以后续站内公告为准。

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 sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-5.5",
    "messages":[{"role":"user","content":"你好"}]
  }'

4. 部署/接入说明

本节用于客户把 sub2api 接入到自己的脚本、服务端程序或客户端工具。你不需要部署 sub2api 服务本身，只需要在你的程序里配置统一的 Base URL 和 API Key。

接入前准备

先在发卡网购买兑换码/卡密，并登录 sub2api 控制台完成兑换。
确认账号余额、订阅或并发权益已经到账。
在中转站创建独立 API Key，格式通常为 sk-...。
复制统一接口地址：https://sub.041714.xyz/v1。

服务端环境变量部署

推荐在服务器、Docker、宝塔计划任务或后端项目里使用环境变量保存 Key，避免把真实 Key 写进代码仓库。

export OPENAI_BASE_URL="https://sub.041714.xyz/v1"
export OPENAI_API_KEY="sk-***"

Docker / Compose 示例

如果你的应用通过 Docker 运行，可在 docker-compose.yml 中注入环境变量。

services:
  app:
    image: your-app:latest
    environment:
      OPENAI_BASE_URL: "https://sub.041714.xyz/v1"
      OPENAI_API_KEY: "sk-***"

宝塔 / Nginx / 后端项目

宝塔站点项目：在项目环境变量或启动命令里加入 OPENAI_BASE_URL 和 OPENAI_API_KEY。
Nginx 只负责反向代理你的业务站点，不需要代理 sub2api；业务程序直接请求 https://sub.041714.xyz/v1 即可。
Node、Python、PHP 等后端均按 OpenAI 兼容 SDK 的 baseURL/base_url 参数接入。

Python SDK 示例

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-***",
    base_url="https://sub.041714.xyz/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js SDK 示例

node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-***",
  baseURL: "https://sub.041714.xyz/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

部署检查

Base URL 必须带 /v1，例如 https://sub.041714.xyz/v1。
请求头必须是 Authorization: Bearer sk-***，不要把兑换码当 API Key。
所有公开文档、截图和教程里都必须隐藏真实 Key，只保留 sk-*** 或 Bearer *** 占位符。
部署后先调用 GET /v1/models 或 POST /v1/chat/completions 验证连通。

5. 鉴权与请求规范

请求头要求

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

路径规范

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

6. 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 sk-***"

补充：推理强度设置

部分推理模型支持在 OpenAI 兼容请求体中加入 reasoning_effort 参数，用来控制模型思考强度。普通对话可以不填该参数，系统会使用默认强度。

可选值

low：快速问答、简单改写、轻量任务，速度优先。
medium：默认推荐，适合多数对话、总结、常规代码问题。
high：复杂推理、代码排错、数学/逻辑分析，思考更充分。
xhigh：超高推理强度，适合特别复杂的长链路分析、疑难代码排错、严谨数学/逻辑推导，通常最慢且消耗最高。

使用建议

强度越高通常延迟和消耗越高，简单任务建议使用 low 或不填；特别复杂任务再使用 xhigh。
不是所有模型都支持推理强度；如果报错，请删除该参数或改用默认。
推荐在 gpt-5.5、gpt-5.2 等推理模型上使用。

Chat Completions 示例

curl

curl https://sub.041714.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "请详细分析这个问题"}
    ],
    "reasoning_effort": "xhigh"
  }'

JSON 参数位置

{
  "model": "gpt-5.5",
  "messages": [{ "role": "user", "content": "请详细分析这个问题" }],
  "reasoning_effort": "xhigh"
}

7. 生图介绍

生图能力适用于文生图、海报图、角色图、商品图、封面图等图片生成场景。当前推荐使用 gpt-image-2，统一通过 OpenAI 兼容图片接口调用。

推荐模型 gpt-image-2

接口地址 POST /v1/images/generations

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

价格参考

图片按张计费，清晰度越高价格越高；最终扣费以系统账单记录为准。

1K $0.0804 每张

2K $0.1206 每张

4K $0.1608 每张

调用示例

curl 文生图示例

curl https://sub.041714.xyz/v1/images/generations \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张商业海报风格图片，主体是一杯冰美式咖啡，背景是夏日海边，蓝白色调，干净高级，产品摄影，柔和自然光，4K，高细节，无文字",
    "size": "1024x1024",
    "n": 1
  }'

提示词怎么写

写清楚主体、场景、风格、构图、光线和画面比例。
商业海报建议补充“干净高级、产品摄影、无文字”。
角色图建议补充人物外观、服装、姿势、背景和镜头感。

常见问题

提示模型不存在时，先确认 API Key 所属分组已开通生图能力。
图片生成按档位计费，不按普通文字对话计费。
不要生成违法、侵权、色情、暴力血腥或侵犯肖像权的内容。

8. 支持模型（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

9. 客户端接入

需要完整图文步骤（含 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

11. 常见问题

401

Key 错误或 Bearer 格式错误。

404

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

429

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

5xx

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

12. 交付检查清单

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

13. 资料海报

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