- 文档
- 参考
接口一览
所有可用的接口及其对应的协议。
| 方法 | 路径 | 协议 | 说明 |
|---|---|---|---|
POST |
/v1/chat/completions |
OpenAI | 对话补全，支持流式 |
POST |
/v1/completions |
OpenAI | 文本补全（旧版接口） |
POST |
/v1/embeddings |
OpenAI | 文本向量 |
POST |
/v1/responses |
OpenAI Responses | Codex 等新一代客户端使用 |
POST |
/v1/messages |
Anthropic Messages | Claude Code、Anthropic SDK 使用 |
POST |
/v1/messages/count_tokens |
Anthropic Messages | 估算输入 token 数 |
GET |
/v1/models |
OpenAI / Anthropic | 当前 Key 可用的模型 |
协议转换
同一个模型可以通过以上任意一种对话接口调用。模型所在渠道原生支持该协议时请求原样转发；否则由网关在 Chat Completions 与目标协议之间转换，包括流式输出与工具调用。
转换只做等价映射，不会悄悄改变请求的含义：无法等价转换的参数（例如 Responses 接口的 previous_response_id）会直接报错，而不是被静默丢弃。
查询可用模型
bash
curl https://console.vailgo.cn/v1/models \ -H "Authorization: Bearer $VOLT_API_KEY"只返回当前可以调用、且这个 Key 有权使用的模型。带 anthropic-version 请求头时按 Anthropic 格式返回。