外观
入门指南
ZEN-AI VIP站（vip.zen-ai.top）是一个 AI 模型聚合 API 服务。你只需要一个接口地址和一个 API Key，就能用 OpenAI 兼容的方式调用 GPT、Claude、Gemini、Grok、DeepSeek、Qwen、Kimi、GLM 等模型，覆盖对话、图像、视频、音频、向量、重排序等场景。
三个要素
| 要素 | 取值 | 说明 |
|---|---|---|
| Base URL | https://vip.zen-ai.top/v1 | OpenAI 兼容格式。Claude、Gemini 原生客户端填 https://vip.zen-ai.top（不带 /v1），详见 接口地址与线路 |
| API Key | sk-xxxxxxxx | 在 控制台 → 令牌 创建，请求头 Authorization: Bearer sk-xxx |
| Model | 如 gpt-4.1-mini | 模型需在令牌所属分组内可用，见 模型列表 或调用 GET /v1/models |
支持的接口格式
同一个 API Key 可以调用下面所有格式的接口，按你的客户端或 SDK 选择即可：
| 格式 | 接口 | 适用场景 |
|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions | 最通用，所有对话模型都可用 → 文档 |
| OpenAI Responses | POST /v1/responses | Codex 等新版工具、推理模型 → 文档 |
| Claude Messages | POST /v1/messages | Claude Code、Anthropic SDK → 文档 |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent | Gemini CLI、Google GenAI SDK → 文档 |
| 图像 | POST /v1/images/generations、/v1/images/edits | GPT Image、DALL·E、Flux 等 → 文档 |
| 视频 | POST /v1/videos、/v1/video/generations | Sora、Veo 等（异步任务）→ 文档 |
| 音频 | POST /v1/audio/speech、/v1/audio/transcriptions | 语音合成、语音识别 → 文档 |
| 向量 / 重排序 | POST /v1/embeddings、/v1/rerank | 检索增强（RAG）→ 文档 |
推荐阅读路径
- 5 分钟快速上手：注册、创建令牌、发出第一个请求。
- 分组与计费：了解分组（渠道）和价格，选对令牌分组。
- 按使用方式选择：
- 在编程工具中使用 → Claude Code、Codex CLI、Gemini CLI 等
- 在自己的代码中调用 → Python、Node.js 等代码示例
- 查接口参数 → API 参考
- 异步生成视频前，先读 异步任务说明。
与官方 API 的关系
- 默认用法：请求与响应格式和各厂商官方 API 一致，把官方 SDK 的
base_url换成本站地址、api_key换成本站令牌即可，业务代码无需修改。 - 模型名称：以本站 模型列表 为准。个别模型提供带后缀的变体（如
-thinking、-nothinking），用于开关思考模式。 - 计费：按官方价格乘以分组倍率计费，详见 分组与计费。
常见问题速查
| 现象 | 可能原因 |
|---|---|
invalid character '<' looking for beginning of value | Base URL 或路径写错，请求落到了网页上（返回了 HTML）。检查是否多写或少写了 /v1 |
401 / 无效的令牌 | API Key 错误、已删除或已禁用 |
当前分组 xxx 下对于模型 xxx 无可用渠道 | 令牌所属分组没有这个模型，换分组或换模型 |
429 | 请求过于频繁或上游限流，稍后重试 |
长时间无响应后 524 | 使用了 Cloudflare 加速线路且非流式请求超过 100 秒，改用流式或主站点 |
更多见 错误码与排查。