--- title: API 兼容矩阵与迁移决策 description: 对比 OpenAI Chat Completions、Responses、Claude Messages、Gemini、嵌入、重排、图像、视频与实时语音接口，选择适合现有应用的迁移路径。 lastUpdated: 2026-08-04 --- 如果现有应用已经使用 OpenAI、Anthropic Claude 或 Google Gemini 的请求格式，通常不需要先重写业务逻辑。先保留原请求格式，替换服务地址和 API Key，再用当前令牌调用 `GET /v1/models` 确认可用模型。 接口存在不代表每个模型都支持该接口。最终可用模型以当前 API Key 调用 `GET /v1/models` 的结果，以及[模型广场](https://infistar.cc/pricing)展示的接口类型为准。 ## API 兼容矩阵 | 使用场景 | 兼容格式与入口 | 传输方式 | 接入时必须确认 | 详细说明 | | -------------------------- | --------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------- | | 获取当前可用模型 | `GET /v1/models` | HTTPS | 使用正式 API Key；保存返回的精确模型 ID | [模型列表](/api-reference/models) | | 通用多轮对话 | `POST /v1/chat/completions` | HTTPS；模型支持时可使用流式响应 | `model`、`messages`，以及客户端是否需要 `stream` | [Chat Completions](/api-reference/chat-completions) | | 结构化输入、工具调用与推理 | `POST /v1/responses` | HTTPS；具体能力由模型决定 | `model`、`input`，以及模型是否支持所用能力 | [Responses API](/api-reference/responses-api) | | Anthropic 原生客户端 | `POST /v1/messages` | HTTPS | `anthropic-version: 2023-06-01`、`model`、`messages`、`max_tokens` | [Claude Messages](/api-reference/claude-format-api) | | Google Gemini 原生客户端 | `POST /v1beta/models/{model}:generateContent`；流式使用 `streamGenerateContent?alt=sse` | HTTPS / SSE | 模型 ID 位于 URL 路径；请求体使用 `contents` | [Gemini GenerateContent](/api-reference/gemini-api) | | 语义检索与向量化 | `POST /v1/embeddings` | HTTPS | 嵌入模型 ID、`input`，以及业务需要的向量维度 | [文本嵌入](/api-reference/embeddings) | | RAG 候选文档二次排序 | `POST /v1/rerank` | HTTPS | 重排模型 ID、`query`、`documents` | [文档重排](/api-reference/document-rerank) | | 图像生成 | `POST /v1/images/generations` | HTTPS | 图像模型 ID、提示词和模型支持的尺寸 / 质量参数 | [图像生成与编辑](/api-reference/image-generation) | | 图像编辑 | `POST /v1/images/edits` | HTTPS | 图像编辑模型 ID、原图、提示词和实际请求格式 | [图像生成与编辑](/api-reference/image-generation) | | 视频生成与查询 | `POST /v1/videos`；`GET /v1/videos/{task_id}` | HTTPS 异步任务 | 保存任务 ID；轮询到终态后再读取或下载结果 | [视频生成与管理](/api-reference/video-generation) | | 实时语音 | `GET /v1/realtime?model={model}` | WebSocket | 使用 `wss://`、服务端可设置的鉴权头和 Realtime 模型 | [实时语音](/api-reference/realtime-audio) | ## 按现有代码选择迁移路径 ### 已经使用 OpenAI SDK 或 OpenAI 兼容客户端 - 现有代码使用 `chat.completions` 时，优先保留 Chat Completions 请求格式。 - 现有代码已经围绕 Responses API、工具调用或结构化输入开发时，使用 `/v1/responses`。 - 不要因为模型名称相似就假定同一个模型同时支持两个入口；先核对模型广场的接口类型并完成最小请求。 ### 已经使用 Anthropic SDK 保留 Messages API 的消息结构，改用 `/v1/messages`，同时保留 `anthropic-version` 请求头并把 API Key 作为 Bearer Token 发送。`max_tokens` 是必填项，不能沿用某些 OpenAI 客户端省略最大输出长度的做法。 ### 已经使用 Google GenAI 或 Gemini 请求格式 保留 `contents`、`generationConfig` 与路径中的模型 ID。普通生成使用 `generateContent`，流式生成使用 `streamGenerateContent?alt=sse`。不要把 OpenAI 的 `messages` 请求体直接发送到 Gemini 原生入口。 ### 正在开发 RAG、图片、视频或语音应用 - RAG 通常先用 Embeddings 生成向量；需要提高候选结果相关性时，再增加 Rerank。两者不是同一个接口，完整流程见 [RAG 检索接入](/integration-guides/rag-retrieval-quickstart)。 - 图片生成和图片编辑使用不同入口，编辑请求还需要原图；具体文件或 URL 形式由模型支持范围决定。 - 视频是异步任务：提交成功只表示已经取得任务 ID，不等于视频已经生成完成。 - Realtime 使用 WebSocket，不应把 API Key 放进公开网页、移动端安装包或公开仓库；浏览器应用应由自己的服务端转发。 ## 迁移检查清单 1. 在[控制台](https://infistar.cc/console)创建独立 API Key，不复用公开示例或前端中的密钥。 2. 国内网络优先使用 `https://infistar.cc/v1`；国际接入可使用 `https://infistar.ai/v1`。一个客户端只配置一个基础地址。 3. 先调用 `GET /v1/models`，把返回的精确模型 ID 写入测试配置，不从旧供应商名称猜测。 4. 按上表选择与现有 SDK 相同的请求格式，完成一个最低成本、非流式的最小请求。 5. 再分别验证流式、工具调用、多模态、异步轮询或 WebSocket 等实际需要的能力。 6. 按[HTTP 状态码排查](/troubleshooting/http-status-troubleshooting)处理 401、403、404、429 与 5xx，不把所有失败都重试成同一请求。 7. 在上线前核对模型广场价格、请求日志与实际用量；不要把内部供应商或渠道名称写入应用配置，后续继续按公开模型 ID 和接口合同接入。 ## 下一步 - 第一次接入：从[网关与基础地址](/integration-guides/gateway-config)开始。 - 鉴权失败：检查[API Key、权限与安全边界](/integration-guides/authentication-permissions)。 - 已经确定接口：进入[API 总览](/api-overview)查看最小参数和各接口说明。 - 需要图形化调试：参考 [Apifox 配置教程](/client-integrations/apifox)。 本页只比较当前公开接口形状和迁移决策，不承诺所有模型具备相同能力，也不展示内部渠道、供应资产或采购成本。