API 概览
零派智能API 提供 OpenAI 兼容的 RESTful 接口，你可以使用任何支持 OpenAI 格式的 SDK 或 HTTP 客户端直接接入，无需额外适配。
Base URL
所有 API 请求都需要发送到你的 Base URL。Base URL 可在平台控制台查看，通常格式为：
https://your-base-url.com完整的接口路径为 Base URL + 接口路径，例如：
https://your-base-url.com/v1/chat/completions建议将 Base URL 设置为环境变量 BASE_URL，不要硬编码在代码中。
接口列表
| 接口 | Method | Path | 说明 |
|---|---|---|---|
| Models | GET | /v1/models | 获取当前可用的模型列表 |
| Chat Completions | POST | /v1/chat/completions | 对话补全，支持流式响应 |
| Responses | POST | /v1/responses | Responses API，支持更灵活的对话编排 |
| Embeddings | POST | /v1/embeddings | 文本向量化 |
| Images | POST | /v1/images/generations | 图像生成 |
| Streaming | - | - | 流式响应使用说明 |
| Errors | - | - | 错误码与错误信息说明 |
认证方式
所有接口均使用 Bearer Token 认证。你需要在每个请求的 Authorization 请求头中携带你的 API Key：
Authorization: Bearer sk-xxxxxxxxxxxxAPI Key 可在平台的 API Key 管理页面创建。详见 Authentication。
速率限制
为保证服务质量，平台对 API 请求进行速率限制：
- 速率限制基于 API Key 维度计算。
- 不同 API Key 可能配置不同的速率上限。
- 超出速率限制时，接口返回
429 Too Many Requests错误。
建议在客户端实现指数退避重试机制，避免短时间内大量重复请求。详见 错误码 - 429。