按任务选择接口
这是本站已有指南的选用入口,不是模型供应商能力清单。模型名称包含
chat、vision 或其他字样也不能替代实际能力确认。
Chat Completions 与 Responses 不可直接换路径
切换接口时同步修改请求体、工具结果结构、响应读取和流式完成判断。不要只把 URL 从
/chat/completions 替换为 /responses,也不要假设网关在所有渠道都能完成等价转换。服务端保存会话、内置工具及资源管理能力须单独确认;本站示例不承诺这些能力在所有部署可用。
最小验证顺序
- 按地址与请求约定确认实际 API 地址,并用同一密钥查询模型。
- 使用对应指南的最小请求,不同时加入工具、图片或结构化输出等多个选项。
- 检查业务完成状态和输出内容,而不只检查 HTTP 200。
- 逐项启用所需能力,每次保留请求时间、模型 ID 和非敏感错误信息,方便对照部署日志。
- 再验证断流、失败和重试策略;不要把客户端自动重试当作能力探测方法。
常见误解
- SDK 有这个方法,所以网关一定支持。 SDK 可以暴露本站范围之外的接口。请以本站API 概览和部署实际能力为准。
- 同一模型能生成图片,就能编辑图片。 输入、编辑、生成属于不同能力,需要分别验证。
- JSON 能解析,就满足业务要求。 还要校验字段类型、值域和业务约束,并处理拒绝及未完成响应。
- 检索排名第一,就足以回答。 仍需检查资料是否相关、是否有权使用以及答案是否有依据,见 RAG 指南。
原生协议与流式工具
Claude Messages与 Gemini generateContent提供独立的原生协议接入示例。需要组装工具参数分片并执行函数时,见 Chat / Responses 流式工具调用。 原生协议的可运行 SSE 与工具闭环见 Claude和 Gemini,包含完成校验与签名保留。查询单个模型
已知模型 ID 时,可运行examples/model.py。它检查 HTTP 200 中的业务错误;模型不存在或不可见时非零退出,不打印完整错误载荷。先按 Python 指南安装依赖,配置同一部署的地址、令牌和模型。路径编码限制见单模型参考。