ZiAI 中转站接入文档

一个 API Key，接入主流 AI 客户端与编程 Agent。按工具查配置，照抄即可跑通。

三条协议，七个工具

ZiAI 是大模型 API 网关，同一域名下同时对外提供多种协议端点。 不同客户端要求的协议不同 —— 这是接入失败最常见的原因。

OpenAI 兼容

https://api.ziai.lol/v1/chat/completions

适用于 ChatBox、CherryStudio、WorkBuddy、ZCode。

OpenAI Responses

https://api.ziai.lol/v1/responses

Codex 专用。新版 Codex 只认这一种协议。

Anthropic Messages

https://api.ziai.lol/v1/messages

Claude Code 专用。地址栏只填站点根域名，不带 /v1。

CC-Switch

推荐图形化管理 Claude Code 与 Codex 的供应商，一键切换多站，上游协议不匹配时可本地转换。开始配置 →

Claude Code

终端编程 Agent，走 Anthropic Messages 协议。配置教程 →

Codex

终端编程 Agent，走 OpenAI Responses 协议。配置教程 →

ChatBox

跨平台聊天客户端，OpenAI 兼容。配置教程 →

CherryStudio

开源桌面客户端，支持多 Key 轮询。配置教程 →

ZCode

Z.ai 桌面 Agent，可加自定义供应商。配置教程 →

WorkBuddy

腾讯桌面 Agent，自定义模型接入。配置教程 →

遇到问题了？

401 / 404 / 429 / 流式中断 / 模型不存在，按报错码查。排错手册 →

示例域名

全站示例统一使用 https://api.ziai.lol。替换为你的实际站点域名后所有命令即可直接使用，详见端点与协议。

示例密钥

一律写作。请勿在任何截图、日志或工单中粘贴真实密钥。

模型 ID

可用模型由站长在后台配置，因部署而异。以操练场与 https://api.ziai.lol/v1/models 的实时返回为准。