# 协议兼容 (/docs/cloud/services/model/concepts/protocols)



协议兼容让你沿用客户端的请求格式；不表示每个模型支持所有协议或官方的全部功能。以模型的 `supported_apis` 和各端点支持说明为准。

只有一个地址 `https://api.deepraxis.ai`，按协议分入口：

| 入口           | 协议                |
| ------------ | ----------------- |
| `/openai`    | OpenAI 系协议        |
| `/anthropic` | Anthropic 系协议     |
| `/google`    | Google Gemini API |

## OpenAI Chat Completions [#openai-chat-completions]

`POST /openai/v1/chat/completions`。常用的对话协议；流式（SSE）、工具调用与多模态输入是否可用取决于模型。 模型能力与字段差异见 [Chat API](/docs/api/compatible/openai/createChatCompletion)；会话标识的作用见[会话亲和](/docs/cloud/services/model/concepts/session-affinity)。

## OpenAI Responses [#openai-responses]

`POST /openai/v1/responses` 及 retrieve / delete / cancel / input\_items。OpenAI 新一代有状态协议；Codex 等 Agent 走这里。支持范围见 [Responses API](/docs/api/compatible/openai/createResponse)。压缩响应与输入 token 计数端点当前未实现，调用返回 501。

## OpenAI Files [#openai-files]

`/openai/v1/files`：上传 `user_data` 文件供后续请求引用；可列出、读元数据、下载、删除。

## OpenAI Images [#openai-images]

`POST /openai/v1/images/generations`：使用目录声明支持图像生成的模型。

## Anthropic Messages [#anthropic-messages]

`POST /anthropic/v1/messages`。Claude Code、Anthropic SDK 走这里。 具体支持范围见 [Messages API](/docs/api/compatible/anthropic/createMessage)。

## Anthropic Files [#anthropic-files]

`/anthropic/v1/files`：上传、列出、读元数据、删除；**上传后不可下载**（与官方一致）。

## Google Gemini API（generateContent） [#google-gemini-apigeneratecontent]

`POST /google/v1beta/models/{model}:generateContent`。目前用于 Gemini 原生协议的图像生成与编辑。

## 模型目录 [#模型目录]

用 `GET /openai/v1/models?api=responses` 查找支持 Responses 的模型，`api=chat,embeddings` 匹配任一协议。原生目录 `GET /model/v1/models` 及模型详情会返回每个模型的 `supported_apis`；原生列表可用 `?supported_api=openai.responses` 筛选。

`GET /openai/v1/models`：列出当前 Key 可调用的模型，OpenAI 风格返回；Kilo Code 等客户端靠它自动发现模型。

Anthropic 客户端使用 `GET /anthropic/v1/models`，Google 客户端使用 `GET /google/v1beta/models`；分别返回对应协议的模型列表。

## 标准化地址 [#标准化地址]

以上每个入口还有一个标准化长路径 `/v1/router/<vendor>/...`，语义完全相同，见 [API 参考](/docs/api/compatible)。

→ 深入：[OpenAI 兼容接口](/docs/cloud/services/model/guides/openai-compatible) · [Anthropic 兼容接口](/docs/cloud/services/model/guides/anthropic-compatible)

[API 参考 →](/docs/api/compatible/openai) · [Cookbook →](/docs/cookbook)