云智 Token Hub · 文档

API 端点总览

云智 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 · /responsesOpenCode、Codex、openai SDK(推荐)
OpenAI 兼容 · 订阅资源池https://llm.piteyun.com/v1同上企业签约客户端
Anthropic 兼容 · 按量计费https://y-llm.piteyun.com/v1/messagesClaude Code、anthropic SDK(推荐)
Anthropic 兼容 · 订阅资源池https://llm.piteyun.com同上企业签约客户端

GET /v1/models

返回当前密钥可用的模型列表,也是 Helper 验证密钥的端点(llm/y-llm 返回一致):

bash
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 无关):

response · wrapped
{
  "code": 0, "message": "success",
  "data": { "choices": […], "usage": {…} }
}

流式:标准 OpenAI SSE

stream: true 返回标准 chat.completion.chunk 事件流,以 data: [DONE] 结束,多数模型在最后一个 chunk 携带 usage。编码工具默认走流式,不受包裹结构影响。

免费池与个别模型的抖动 流式为标准 OpenAI SSE,但在上游负载波动时极少数情况下会出现个别无法解析的数据行;客户端应容错处理:跳过无法解析的行、不强依赖流内 usage。编码工具建议优先使用 glm-5.3(主)/glm-5.3-flash(小)组合,是当前验证最多、表现最稳的搭配。

POST /v1/messages(Anthropic)

返回标准 Anthropic message 格式(无包裹),流式为标准 SSE:message_start → thinking block → text block → message_delta → message_stop。推理模型的推理过程经 thinking block 输出。

bash
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":"你好"}]}'

错误码

状态码含义处理建议
401API Key 无效或过期检查是否复制了遮罩值;控制台重建密钥
402额度不足控制台充值或购买资源包
403权限不足 / 端点路径错误检查密钥权限;确认 Base URL 正确(Anthropic 用根端点)
404端点不存在注意:云智 404 是 200 + HTML 兜底页,按 content-type 判断
400请求参数错误检查 model ID 是否来自 /v1/models 实时列表