API 参考 - ZeroCat 文档

ZeroCat 提供与 OpenAI、Anthropic Claude、Google Gemini 兼容的接口。大多数现有的 SDK 和客户端，只要把地址和密钥换成 ZeroCat 的即可使用。

接入地址

用途	地址
OpenAI 兼容接口（SDK 的 `base_url`）	`https://zero.cat/v1`
Anthropic / Gemini 原生接口	`https://zero.cat`

也可以把 zero.cat 换成三网优化直连端点 api.zero.cat，详见接入地址速查。

鉴权

所有 AI 模型接口都使用 API 密钥（sk- 开头）鉴权：

格式	请求头
OpenAI 兼容接口	`Authorization: Bearer sk-你的API密钥`
Claude 原生接口	`x-api-key: sk-你的API密钥`（也支持 Bearer）
Gemini 原生接口	`x-goog-api-key: sk-你的API密钥`，或查询参数 `?key=sk-你的API密钥`

API 密钥只用于调用模型。如果要管理账户、密钥和日志，请使用个人访问令牌调用管理接口，两者不能混用。

快速示例

curl https://zero.cat/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"你好"}]}'

模型名是示例，请换成模型广场中你的分组可用的模型 ID。更多语言的示例见使用 API 与游乐场。

接口分类

模型

获取可用的模型列表。

聊天

Chat Completions、Responses、Claude Messages、Gemini。

补全

传统文本补全接口。

嵌入

生成文本向量。

重排序

按相关性对文档排序。

内容审查

对输入内容进行审查。

图像

生成和编辑图像。

音频

语音合成、转录与翻译。

实时语音

基于 WebSocket 的实时对话。

视频

视频生成任务：通用格式、Sora、可灵、即梦。

流式响应

Chat Completions、Responses、Claude Messages 等接口支持流式输出：请求体中设置 "stream": true，响应以 Server-Sent Events（SSE）格式逐段返回。Gemini 原生格式使用 streamGenerateContent 操作。

异步任务

视频、Midjourney、Suno 等生成任务是异步的：提交接口会立即返回任务 ID，之后用查询接口轮询状态和结果。任务记录也可以在控制台的任务日志中查看。

错误处理

出错时，接口会返回非 2xx 状态码和错误信息，常见情况如下：

状态码	常见原因
`401`	API 密钥无效、已禁用或已过期
`403`	密钥没有权限调用该模型，或请求 IP 不在密钥的白名单中
`404`	请求路径错误，例如 `/v1` 多写或漏写
`429`	请求过于频繁，或当前分组负载已饱和，请稍后重试
`5xx`	上游服务暂时异常，请稍后重试

余额或密钥额度不足、模型在你的分组中不可用时，也会返回对应的错误信息。排查方法见常见问题。

接口能否调用成功，还取决于你的分组里有没有对应类型的模型。例如调用图像生成接口，需要分组中有图像模型。

​接入地址

​鉴权

​快速示例

​接口分类

模型

聊天

补全

嵌入

重排序

内容审查

图像

音频

实时语音

视频

​流式响应

​异步任务

​错误处理

接入地址

鉴权

快速示例

接口分类

流式响应

异步任务

错误处理