云智 Token Hub 进入控制台
DOCS 全部教程经真实请求验证

一枚 API Key, 像调用 OpenAI 一样调用所有模型

统一接入 GLM、Kimi、Qwen、DeepSeek 等主流模型,兼容 OpenAIAnthropic 协议,按量计费。从创建密钥到首次请求,平均 10 分钟完成。

7
在线模型
2
兼容协议
<50ms
网关延迟
10min
平均接入
API Key 验证通过GET /v1/models · 200 OK
开箱即用的工具与 SDKWorks with
Protocols

一枚 Key,三套协议全覆盖

同一枚 API Key 在三个端点间通用,认证方式统一为 Bearer 认证,切换工具不需要重新创建密钥。

主力端点

OpenAI 兼容 /v1

标准 Chat Completions 协议,OpenCode 与 openai SDK 直连。

  • POST /v1/chat/completions,支持 SSE 流式
  • GET /v1/models 实时获取可用模型
  • 非流式响应为包裹结构,见 API 总览
Claude Code

Anthropic 兼容根端点

标准 Messages 协议,Claude Code 自动拼接 /v1/messages。

  • 同时接受 Bearer 与 x-api-key 认证
  • 推理过程经 thinking block 输出
  • 流式为标准 SSE,message_start 起
关键路径已验证

OpenAI Responses /v1/responses

面向 Codex CLI 的 Responses 协议,数组 input + 流式。

  • Codex 0.154+ 关键路径实测通过
  • yunzhi-helper 探测成功后自动写入配置
  • config.toml + auth.json 一键生成
Integration Path

从注册到首次请求,三步走完

不需要读完整份文档——沿着这条路径,每一步都有对应的教程章节。

Coding Tools

每个工具都有实测教程

yunzhi-maas-helper 交互菜单完成验证与写入,或按教程手动配置。

Developers

三条命令发出首个请求

使用 openai SDK 时只需把 base_url 指向云智网关,其余代码与调用 OpenAI 完全一致。

01创建并复制密钥控制台创建 90 天密钥,避免使用遮罩值
02指向网关地址OpenAI 兼容用 /v1,Anthropic 用根端点
03验证模型回复优先使用流式,避开非流式包裹结构
bash · curl
curl https://maas.piteyun.com/v1/chat/completions \
  -H "Authorization: Bearer $YUNZHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [
      {"role": "user", "content": "只回复:配置成功"}
    ]
  }'
python · openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://maas.piteyun.com/v1",
)

resp = client.chat.completions.create(
    model="glm-5.3-flash",
    messages=[{"role": "user", "content": "只回复:配置成功"}],
)
print(resp.choices[0].message.content)
node · openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YUNZHI_API_KEY,
  baseURL: "https://maas.piteyun.com/v1",
});

const resp = await client.chat.completions.create({
  model: "glm-5.3-flash",
  messages: [{ role: "user", content: "只回复:配置成功" }],
});
console.log(resp.choices[0].message.content);
FAQ

常见问题,先看这里

以下问题均来自真实接入排查,覆盖密钥、工具配置与调用行为。没有找到答案可以翻完整的 FAQ 页。

查看全部 FAQ
9篇实测教程
2026-09-13最近更新
最常见原因是复制了列表里的遮罩文本(sk-••••...••••)。使用目标行的"显示 / 复制"按钮获取完整值;仍失败则检查有效期与配额,必要时删除重建。
前往控制台充值或购买资源包;先在账单页确认消耗曲线是否正常,排除密钥泄露后的异常调用。
运行 yunzhi-helper,进入对应工具的管理菜单选择配置装载 / 配置刷新,然后完全退出并重启工具。配置只在新进程启动时加载。
刷新配置后用 /status 核对:base URL 应为根端点 https://maas.piteyun.com(多写 /v1 会 403)。不要用网页登录绕过网关。
非流式响应是包裹结构,取 body.data.choices;流式是标准 OpenAI SSE。优先使用流式可完全避开这个问题。
能。/v1/responses 的 Codex 关键路径已实测验证,helper 会在探测成功后自动放行并写入配置,详见配置 Codex 教程。

十分钟,接好第一个工具

从创建密钥到真实请求验证,快速开始教程覆盖每一个步骤。