大约 4 分钟
认证与令牌
接入结论
- OpenAI 兼容：
Authorization: Bearer <你的 API 令牌> - Anthropic Messages：
Authorization: Bearer <你的 API 令牌>或x-api-key: <你的 API 令牌>二选一 - 额外要求：Anthropic Messages 必须带
anthropic-version: 2023-06-01 - 令牌创建入口：站内"令牌管理"页，必须在创建时选定分组
- 错误码：
401令牌问题；403分组不匹配；404模型 ID 不在分组内
新用户福利（实名后到账）
- 注册赠送：50 万 Token，所有分组通用
- 邀请奖励：每邀请一位新用户成功注册并实名，邀请人再得 50 万 Token
- 自充加赠 / 推广返佣：按累计有效充值阶梯计算，详见 自充加赠与推广返佣
接入测试期间几乎不会被额度限制；上线前再去 充值页 按真实用量买好生产额度。
认证 Header
平台同时支持 OpenAI 兼容和 Anthropic 原生两套头部写法，二者请求体格式不同，但认证字段都接受 Bearer Token。
OpenAI 兼容（聊天 / 图像 / 视频 / 模型列表）
POST /v1/chat/completions HTTP/1.1
Host: www.yuzhixiaolongxia.com
Authorization: Bearer 你的令牌
Content-Type: application/jsonAnthropic Messages（Claude 原生 SDK）
POST /v1/messages HTTP/1.1
Host: www.yuzhixiaolongxia.com
Authorization: Bearer 你的令牌
anthropic-version: 2023-06-01
Content-Type: application/json也可以把 Authorization: Bearer 换成 x-api-key: 你的令牌，效果等价；推荐统一使用 Authorization。
令牌与分组对应关系
新用户开箱即用 6 个预设分组，创建令牌时必须选其中一个，否则后续调用一律 403。
| 想调用的模型 | 创建令牌时选这个分组 | 建议接口格式 |
|---|---|---|
| Claude 家族（含 Claude Code） | Claude 家族 | OpenAI 兼容 或 Anthropic Messages |
| GPT / Codex 家族 | Codex 家族 | OpenAI 兼容 |
| Gemini 文本家族 | Gemini 家族 | OpenAI 兼容 |
| 图像生成 | 图片 | OpenAI Images |
| 视频生成（Sora / Seedance / Veo3） | 视频 | OpenAI Images 风格的异步任务 |
| 第三方多品牌混合 | 外接渠道 | OpenAI 兼容 |
分组不匹配会直接 403
Claude 令牌不能调 Codex 模型，反之亦然。模型 ID 在分组里没开放就拿不到回包。详见 令牌分组介绍。
SDK 最小示例
Python（OpenAI SDK）
from openai import OpenAI
client = OpenAI(
api_key="你的令牌",
base_url="https://www.yuzhixiaolongxia.com/v1",
)
resp = client.chat.completions.create(
model="claude-opus-4-7",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)TypeScript / Node.js（OpenAI SDK）
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.YZX_API_KEY,
baseURL: "https://www.yuzhixiaolongxia.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-opus-4-7",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);Python（Anthropic SDK）
import anthropic
client = anthropic.Anthropic(
api_key="你的令牌",
base_url="https://www.yuzhixiaolongxia.com",
)
message = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)TypeScript（Anthropic SDK）
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.YZX_API_KEY,
baseURL: "https://www.yuzhixiaolongxia.com",
});
const message = await client.messages.create({
model: "claude-opus-4-7",
max_tokens: 1024,
messages: [{ role: "user", content: "你好" }],
});
console.log(message.content[0]);错误码
| HTTP | 常见消息 | 真实原因 | 处理建议 |
|---|---|---|---|
401 | invalid api key / Unauthorized | 令牌空、过期、复制时被截断、前后带空格 | 重新复制令牌；用环境变量装载并先 echo 一遍 |
403 | forbidden / group mismatch | 令牌分组与模型不匹配 | 换分组对应的令牌，或在管理后台把模型挪进分组 |
404 | model not found | 模型 ID 拼写错；该分组未开放此模型 | 调 GET /v1/models 列出当前可用 ID；或去模型广场复制 |
413 | Request Entity Too Large | 上下文 + 输入超过单次限制 | 在 Claude Code 里用 /compact 压缩；或切到大窗口模型 |
429 | rate limit | 单令牌并发超限 | 指数退避；把测试令牌和生产令牌拆开 |
5xx | internal error / bad gateway | 上游临时压力 | 1-2 分钟后重试；如长时间持续，去 监控页 看可用性 |
令牌安全建议
一旦写入仓库就算泄露
不要把令牌写进 Git、不要写进客户端代码、不要写进日志和异常消息。前端/移动端/小程序不要直接请求平台 API，统一由你自己的业务后端代调。
- 用环境变量或 Secret 管理（例如
YZX_API_KEY）。 - 给令牌设置额度上限，防止意外超额。
- 测试和生产建议拆成两个令牌，便于独立轮换。
- 怀疑泄露时，立即去管理后台禁用旧令牌并重建。
上一步：开发者 API 总览 | 下一步：聊天补全