字段与用途

字段路径位置类型必填填写规则与说明允许值 / 约束示例
choices响应 JSONarray否旧 Completion 从 choices[].text 取续写结果,不是 message.content;检查 finish_reason。--
choices[]响应 JSONobject否数组元素。--
choices[].text响应 JSONstring否---
choices[].index响应 JSONinteger否---
choices[].finish_reason响应 JSONstring否---

升级步骤

把 prompt 转为 messages 中的 user 内容;模型改为支持 Chat 的准确型号;输出读取从 choices[].text 改为 choices[].message.content。重新评估 max_completion_tokens 和默认采样,不逐项复制旧参数。

旧的 text_completion 与新的 chat.completion 对象名称不同。流式 delta、工具回传和多模态都是 Chat 的额外工作流。

调用示例与参考

查看完整三语言调用。OpenAI 公共 API 规范。

常见错误

401:检查本站 API Key 和 Bearer 格式;403:确认此 Key 可用该模型;429:遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误,避免盲目重发;其他通用排查见聊天接入总览。