兼容性

统一 API 的目标是降低多模型接入时的重复适配成本。不同模型在参数、工具调用、多模态输入和响应格式上仍然可能存在差异，应在测试环境中确认。

OpenAI 兼容格式

常见的聊天、补全和嵌入类请求可使用 OpenAI 兼容格式接入。实际支持的端点、参数和模型范围以控制台与当前接入说明为准。

迁移建议

将服务地址、模型名称和 API Key 放入部署配置，不要写死在业务代码中。
将请求构造和响应解析集中在一个客户端模块，减少模型调整时的修改范围。
对工具调用、结构化输出和流式响应编写针对性的集成测试。
切换模型前，使用一组固定业务样本比较质量、延迟和用量表现。

协议边界

兼容格式有助于统一基础请求，但不意味着所有模型参数与响应行为完全相同。涉及长上下文、视觉输入、函数调用或推理输出时，请按实际模型能力调整请求与容错策略。