云智 Token Hub 提供两套兼容协议,共用同一枚 API Key。认证方式统一为 Authorization: Bearer <key>(Anthropic 端点同时接受 x-api-key)。两枚端点(按量 y-llm / 订阅 llm)共用同一枚 Key,区别只在扣什么账户。
| 协议 | Base URL | 端点 | 典型客户端 |
|---|---|---|---|
| OpenAI 兼容 · 按量计费 | https://y-llm.piteyun.com/v1 | /chat/completions · /models · /responses | OpenCode、Codex、openai SDK(推荐) |
| OpenAI 兼容 · 订阅资源池 | https://llm.piteyun.com/v1 | 同上 | 企业签约客户端 |
| Anthropic 兼容 · 按量计费 | https://y-llm.piteyun.com | /v1/messages | Claude Code、anthropic SDK(推荐) |
| Anthropic 兼容 · 订阅资源池 | https://llm.piteyun.com | 同上 | 企业签约客户端 |
GET /v1/models
返回当前密钥可用的模型列表,也是 Helper 验证密钥的端点(llm/y-llm 返回一致):
curl -H "Authorization: Bearer $YUNZHI_API_KEY" \
https://y-llm.piteyun.com/v1/models
响应为裸数组 [{"id": "glm-5.3"}, …](非 OpenAI 标准的 {data: […]} 包裹,客户端解析时注意兼容)。未带有效密钥返回 401。当前可售 10 个模型:glm-5.3、glm-5.3-flash、glm-5.2、glm-5.1、deepseek-v4.1-flash、deepseek-v4-flash、deepseek-v4-flash-0731、kimi-k2.5、kimi-k2.6、minimax-m3。
POST /v1/chat/completions
非流式:注意包裹结构
stream: false 时网关返回包裹结构 {code, message, data},标准 openai SDK 直接读 body.choices 会得到 undefined,请从 body.data.choices 取值(与 UA 无关):
{
"code": 0, "message": "success",
"data": { "choices": […], "usage": {…} }
}
流式:标准 OpenAI SSE
stream: true 返回标准 chat.completion.chunk 事件流,以 data: [DONE] 结束,多数模型在最后一个 chunk 携带 usage。编码工具默认走流式,不受包裹结构影响。
POST /v1/messages(Anthropic)
返回标准 Anthropic message 格式(无包裹),流式为标准 SSE:message_start → thinking block → text block → message_delta → message_stop。推理模型的推理过程经 thinking block 输出。
curl https://y-llm.piteyun.com/v1/messages \ -H "Authorization: Bearer $YUNZHI_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{"model":"glm-5.3-flash","max_tokens":100, "messages":[{"role":"user","content":"你好"}]}'
错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 401 | API Key 无效或过期 | 检查是否复制了遮罩值;控制台重建密钥 |
| 402 | 额度不足 | 控制台充值或购买资源包 |
| 403 | 权限不足 / 端点路径错误 | 检查密钥权限;确认 Base URL 正确(Anthropic 用根端点) |
| 404 | 端点不存在 | 注意:云智 404 是 200 + HTML 兜底页,按 content-type 判断 |
| 400 | 请求参数错误 | 检查 model ID 是否来自 /v1/models 实时列表 |