先匹配协议
| 协议 | 常见用途 | 返回处理 |
|---|---|---|
| OpenAI Chat Completions | 通用文本聊天与兼容客户端 | 读取 choices，流式读取 delta |
| OpenAI Responses | 要求 Responses 的模型或应用 | 读取 output 或协议事件，不套用 choices |
| Anthropic Messages | 使用 Anthropic 原生协议的工具 | 按内容块与事件类型处理 |
| Gemini 原生格式 | 明确使用 Gemini SDK 的应用 | 按对应模型操作与返回结构处理 |
本站的模型调用 API 参考用于查阅已提供的模型接口。看到某个模型名称，不等于该模型通过所有协议均可调用。
逐项验证实际能力
先测试普通文本，再测试业务真正使用的流式输出、工具调用、结构化输出、图片或音频。每次只增加一项能力，便于确认是协议、模型还是参数造成失败。
温度、输出长度、推理参数、消息角色和工具定义在不同模型之间可能不同。遇到“不支持的参数”时从请求中移除非必需项，按对应文档重新添加，不要把全部参数照搬。
工具调用不是模型替你执行代码
模型返回工具名称和参数后，由你的应用验证参数并执行允许的工具，再把结果回传。对可能修改数据的操作进行业务授权，防止重复调用；不要直接执行模型输出的任意命令。
从其他供应商迁移
保留一组脱敏测试样本，比较响应结构、完成原因、流式事件、费用和错误处理。模型名、地址、协议三项一起核对，不要只替换 API Key 就认定迁移完成。
下一步：首个 HTTP 请求 · 上线检查。