GET /v1/models 确认可用模型。
API 兼容矩阵
| 使用场景 | 兼容格式与入口 | 传输方式 | 接入时必须确认 | 详细说明 |
|---|---|---|---|---|
| 获取当前可用模型 | GET /v1/models | HTTPS | 使用正式 API Key；保存返回的精确模型 ID | 模型列表 |
| 通用多轮对话 | POST /v1/chat/completions | HTTPS；模型支持时可使用流式响应 | model、messages，以及客户端是否需要 stream | Chat Completions |
| 结构化输入、工具调用与推理 | POST /v1/responses | HTTPS；具体能力由模型决定 | model、input，以及模型是否支持所用能力 | Responses API |
| Anthropic 原生客户端 | POST /v1/messages | HTTPS | anthropic-version: 2023-06-01、model、messages、max_tokens | Claude Messages |
| Google Gemini 原生客户端 | POST /v1beta/models/{model}:generateContent；流式使用 streamGenerateContent?alt=sse | HTTPS / SSE | 模型 ID 位于 URL 路径；请求体使用 contents | Gemini GenerateContent |
| 语义检索与向量化 | POST /v1/embeddings | HTTPS | 嵌入模型 ID、input，以及业务需要的向量维度 | 文本嵌入 |
| RAG 候选文档二次排序 | POST /v1/rerank | HTTPS | 重排模型 ID、query、documents | 文档重排 |
| 图像生成 | POST /v1/images/generations | HTTPS | 图像模型 ID、提示词和模型支持的尺寸 / 质量参数 | 图像生成与编辑 |
| 图像编辑 | POST /v1/images/edits | HTTPS | 图像编辑模型 ID、原图、提示词和实际请求格式 | 图像生成与编辑 |
| 视频生成与查询 | POST /v1/videos；GET /v1/videos/{task_id} | HTTPS 异步任务 | 保存任务 ID；轮询到终态后再读取或下载结果 | 视频生成与管理 |
| 实时语音 | GET /v1/realtime?model={model} | WebSocket | 使用 wss://、服务端可设置的鉴权头和 Realtime 模型 | 实时语音 |
按现有代码选择迁移路径
已经使用 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 检索接入。
- 图片生成和图片编辑使用不同入口，编辑请求还需要原图；具体文件或 URL 形式由模型支持范围决定。
- 视频是异步任务：提交成功只表示已经取得任务 ID，不等于视频已经生成完成。
- Realtime 使用 WebSocket，不应把 API Key 放进公开网页、移动端安装包或公开仓库；浏览器应用应由自己的服务端转发。
迁移检查清单
- 在控制台创建独立 API Key，不复用公开示例或前端中的密钥。
- 国内网络优先使用
https://infistar.cc/v1；国际接入可使用https://infistar.ai/v1。一个客户端只配置一个基础地址。 - 先调用
GET /v1/models，把返回的精确模型 ID 写入测试配置，不从旧供应商名称猜测。 - 按上表选择与现有 SDK 相同的请求格式，完成一个最低成本、非流式的最小请求。
- 再分别验证流式、工具调用、多模态、异步轮询或 WebSocket 等实际需要的能力。
- 按HTTP 状态码排查处理 401、403、404、429 与 5xx，不把所有失败都重试成同一请求。
- 在上线前核对模型广场价格、请求日志与实际用量；不要把内部供应商或渠道名称写入应用配置，后续继续按公开模型 ID 和接口合同接入。
下一步
- 第一次接入：从网关与基础地址开始。
- 鉴权失败：检查API Key、权限与安全边界。
- 已经确定接口：进入API 总览查看最小参数和各接口说明。
- 需要图形化调试：参考 Apifox 配置教程。