进阶能力索引
当基础文本、图片、模型与任务接口不能覆盖需求时,再从这里定位对应的扩展能力。
这些接口不是每个接入都需要,也不代表所有账号和模型默认开放。生产接入前,请确认能力已开通,并以目标接口的实际请求体和返回体为准。
先从稳定主路径开始
大多数应用应优先验证以下接口:
只有当业务明确需要另一种请求协议、文件工作流、多模态向量或实时双向连接时,再进入扩展接口。
按能力查找接口
接入一项进阶能力
确认业务确实需要
先写清楚基础接口不能满足的具体要求,例如需要文件生命周期、调用前 Token 估算或实时双向连接。
确认账号与模型已开放
不要把“文档列出接口”等同于“当前账号一定可用”。先确认目标模型、权限和相关资源已具备。
从最小请求验证协议
只传必需字段,保存原始状态码和响应体。进阶接口之间的数据结构不同,不能直接复用 Chat Completions 的解析逻辑。
单独设计生命周期
文件、上传会话和 WebSocket 都包含额外状态。明确创建、使用、结束、失败与清理分别由谁处理。
再补生产保障
加入超时、重试边界、资源清理、日志脱敏、用量观察和异常告警,并用真实失败场景验证。