OpenAI 兼容用法详解

兼容到什么程度

九焱平台的推理接口对齐主流的 OpenAI 风格协议，支持对话补全与流式返回。这意味着你现有的客户端代码、SDK 与工具链多数情况下无需改动逻辑，只需把基础地址与密钥替换为平台提供的值。

三处需要替换的配置

第一，基础地址（base url）指向平台的兼容接口域名；第二，API 密钥换成你在控制台创建的那一把；第三，模型名填平台在线模型的标识。除此之外，请求体与响应结构与你熟悉的写法一致。

对话补全

发送一组消息，平台返回模型的回复。你可以设置温度、最大 token 等常见参数。系统消息用于设定角色与约束，用户消息承载实际问题，多轮对话把历史消息按顺序拼接即可。

流式返回

开启流式后，回复会以增量片段的形式逐步下发，适合做打字机效果的交互。注意在客户端正确处理分片与结束标记，确保最后一段被完整拼接。

错误处理与限流

请求失败时，平台返回带有清晰状态码与说明的错误体。建议对鉴权失败、额度不足、限流这几类做区分处理：鉴权失败检查密钥，额度不足及时充值，触发限流则退避重试。把这些当成正常工程实践纳入你的客户端。

小结

对齐既有协议的好处是迁移成本极低。先在测试环境替换三处配置跑通，再逐步切量到生产，平稳完成接入。