ZhiFlo API 参考
这里按请求目标列出可用入口。第一次调用 API 时,先完成 发送第一次 API 请求,再回来查字段。
Models
标题为“Models”的章节GET /v1/models列出当前 Token 可以看到的模型。响应中的 data[].id 可用作其他请求的模型 ID。
Chat Completions
标题为“Chat Completions”的章节POST /v1/chat/completions使用 messages 发送角色消息,响应内容位于 choices 中。适合要求 OpenAI Chat Completions 格式的客户端和程序。
Responses
标题为“Responses”的章节POST /v1/responses使用 Responses 格式发送生成请求。Codex 自定义 provider 使用这一请求方式。
Messages
标题为“Messages”的章节POST /v1/messages使用 Messages 格式发送请求。Claude Code 通过根地址 https://api.zhiflo.com 自动访问该路径。
连接与请求值
标题为“连接与请求值”的章节| 项目 | 何时需要 | 值 |
|---|---|---|
| 服务根地址 | 识别 API 主机 | https://api.zhiflo.com |
| OpenAI 兼容 Base URL | 配置兼容客户端或 SDK | https://api.zhiflo.com/v1 |
| 认证 | 每个请求 | Authorization: Bearer <YOUR_ZHIFLO_TOKEN> |
| 内容类型 | POST 请求 | application/json |
| 模型 | Chat Completions、Responses 和 Messages 请求 | 当前账户列表中的完整模型 ID |
不要把 Token 放进 URL 或请求正文。认证格式见 Bearer Token 认证,状态码见 API 错误。