协议兼容性
网关同时接受 OpenAI、Anthropic 与 Gemini 三套协议,本页说明各自的入口与路径。
Base URL 是 https://ai.roibest.com。同一个网关同时接受三套协议,路径决定按哪一套解析。
| 协议 | 客户端填的 Base URL | 主要路径 |
|---|---|---|
| OpenAI 兼容 | https://ai.roibest.com/v1 |
/v1/chat/completions、/v1/responses、/v1/embeddings |
| Anthropic 兼容 | https://ai.roibest.com |
/v1/messages |
| Gemini 兼容 | https://ai.roibest.com/v1beta |
/v1beta/models/{model}:generateContent |
Anthropic 生态的 SDK 会自行拼接 /v1/messages,所以 Base URL 不带 /v1。
| 分类 | 说明 |
|---|---|
| 模型列表 | /v1/models 按请求头自动返回 OpenAI、Anthropic 或 Gemini 格式 |
| 对话 | Chat Completions、Responses、Claude Messages、Gemini generateContent |
| 文本补全 | /v1/completions |
| 图片生成 | OpenAI 兼容格式与 Qwen 千问格式 |
| 视频生成 | Sora 兼容格式、Kling 格式、即梦格式,以及通用任务接口 |
| 音频 | 转录、翻译、文本转语音 |
| 向量与重排 | Embeddings、Rerank |
| 其他 | Moderations、Realtime WebSocket |
逐个接口的参数、响应结构与代码示例见左侧的接口列表。
模型列表的格式自适应
Section titled “模型列表的格式自适应”/v1/models 按请求头判断返回格式:
- 带
x-api-key和anthropic-version时返回 Anthropic 格式; - 带
x-goog-api-key或key查询参数时返回 Gemini 格式; - 其他情况返回 OpenAI 格式。
未开放的接口
Section titled “未开放的接口”/v1/fine-tunes 和 /v1/files 两组接口尚未实现,已从本参考中移除。调用它们不会得到有效响应。
curl https://ai.roibest.com/v1/models \ -H "Authorization: Bearer $ROIBEST_API_KEY"