API 参考概览

Base URL

https://vip.zen-ai.top

所有接口路径都拼接在 Base URL 之后，例如 https://vip.zen-ai.top/v1/chat/completions。其他可用线路见 接口地址与线路。

认证

在 控制台 → 令牌 创建令牌后，按接口格式放在请求头中：

接口格式	请求头
OpenAI 兼容	Authorization: Bearer sk-xxx
Claude Messages	x-api-key: sk-xxx，并携带 anthropic-version: 2023-06-01
Gemini 原生	x-goog-api-key: sk-xxx 或 URL 参数 ?key=sk-xxx
账户管理接口	Authorization: Bearer <系统访问令牌> + New-Api-User: <用户 ID>，见 管理接口说明

请求与响应

• 请求体为 UTF-8 编码的 JSON（Content-Type: application/json）；上传文件的接口（图片编辑、语音识别等）使用 multipart/form-data。
• 各接口的请求与响应格式与对应厂商的官方 API 保持一致，官方 SDK 可以直接使用。
• 流式输出：请求中设置 "stream": true（Gemini 使用 :streamGenerateContent?alt=sse），响应为 text/event-stream，每个事件以 data: 开头；OpenAI 格式以 data: [DONE] 结束。

错误格式

{
  "error": {
    "message": "错误描述 (request id: 2026092920...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

message 末尾的 request id 可用于向客服定位问题。状态码与常见错误见 错误码与排查。

在线调试

每个接口页面顶部的 在线调试 按钮会打开调试面板：

1. 选择请求线路，填写 API Key（仅保存在你的浏览器中，可选择关闭页面后清除）。
2. 选择示例或修改请求体，点击 发送请求（快捷键 Ctrl/⌘ + Enter）。
3. 右侧实时显示响应：流式输出会自动合并文本，图片、音频、视频会直接预览。
4. 点击 复制为 cURL 可得到等价的命令行请求。

请求由浏览器直接发往所选线路，不经过文档站服务器。账户管理类接口和 WebSocket 接口需要在服务端调用，不提供在线调试。

接口一览

分类	方法	路径	说明
文本对话	POST	/v1/chat/completions	聊天补全（OpenAI 兼容，所有对话模型）
	POST	/v1/responses	创建模型响应（Responses API）
	POST	/v1/completions	文本补全（旧版）
	GET	/v1/models	列出可用模型
Claude	POST	/v1/messages	Claude 原生消息接口
Gemini	POST	/v1beta/models/{model}:generateContent	生成内容
	POST	/v1beta/models/{model}:streamGenerateContent	流式生成内容
	POST	/v1beta/models/{model}:generateContent	图片生成与编辑
	POST	/v1beta/models/{model}:embedContent	文本向量
	GET	/v1beta/models	列出模型
图像	POST	/v1/images/generations	生成图像
	POST	/v1/images/edits	编辑图像
视频	POST	/v1/videos	创建视频任务
	GET	/v1/videos/{video_id}	查询视频任务
	GET	/v1/videos/{video_id}/content	下载视频内容
	POST	/v1/video/generations	统一视频接口
音频	POST	/v1/audio/speech	文本转语音
	POST	/v1/audio/transcriptions	语音转文字
	WSS	/v1/realtime	实时语音对话
向量	POST	/v1/embeddings	创建向量
	POST	/v1/rerank	重排序
账户	GET	/v1/dashboard/billing/subscription	查询令牌额度
	GET	/api/user/self	获取用户信息
	GET	/api/token/	令牌管理（增删改查）