文字系列
模型支持矩阵
按协议风格和能力类型查看文本系列支持范围、典型模型家族和推荐入口。
通用对话
POST /v1/chat/completions,适合聊天、Agent、长文本生成和多模态输入。
OpenAI Responses
POST /v1/responses,适合工具调用、结构化输出和上下文续接。
Claude 原生
POST /v1/messages,保留 Anthropic Messages 协议。
Gemini 原生
POST /v1beta/models/{model}:{action} 与 GET /v1beta/models。
认证方式
大多数文字 relay 接口使用 Bearer Token:
Authorization: Bearer YOUR_API_KEY
Claude 原生格式同时兼容:
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Gemini 原生格式同时兼容:
x-goog-api-key: YOUR_API_KEY
接口清单
| Method | Path | 页面 | 说明 |
|---|
POST | /v1/chat/completions | 通用对话接口(默认流式) | OpenAI Chat Completions 兼容格式,文档默认展示流式调用 |
POST | /v1/chat/completions | 通用对话接口(默认非流式) | 同一路由的非流式写法 |
POST | /v1/completions | 文本补全接口 | Legacy Completions 兼容格式 |
POST | /v1/messages | Claude 消息接口 | Anthropic Messages 原生协议 |
POST | /v1/responses | OpenAI 多模态响应接口 | Responses API |
POST | /v1/responses/compact | OpenAI 多模态响应接口 | 上下文压缩 |
GET | /v1/realtime | Realtime 接口 | OpenAI Realtime 兼容 WebSocket |
GET | /v1/models | 模型列表 | OpenAI/Claude/Gemini 兼容模型列表 |
GET | /v1/models/{model} | 模型列表 | 单模型查询 |
GET | /v1beta/models | Gemini 原生格式 | Gemini 原生模型列表 |
POST | /v1beta/models/{model}:{action} | Gemini 原生格式 | Gemini 原生推理与图像/视频相关动作 |
GET | /v1beta/openai/models | 模型列表 | Gemini 兼容模型列表 |
POST | /pg/chat/completions | 通用对话接口(默认非流式) | Playground 调试路由,使用登录态而非 API Key |
通用错误码
| 状态码 | 说明 |
|---|
400 | 请求参数错误,例如模型名不存在、消息结构无效、工具定义不合法 |
401 | API Key 缺失、无效或过期 |
402 | 额度不足 |
413 | 请求体过大 |
429 | 请求频率超限 |
500 | 服务端内部错误 |
503 | 上游不可用或系统临时过载 |
如果接口页里标记了“可选”参数,不代表所有模型都支持该字段。最终是否透传、是否生效,仍取决于实际分发到的渠道能力。
推荐阅读顺序
- 文本模型支持矩阵
- 通用对话接口(默认流式)
- OpenAI 多模态响应接口
- Claude 消息接口
- Gemini 原生格式
- 模型列表
- Realtime 接口