字段与用途
| 字段路径 | 位置 | 类型 | 必填 | 填写规则与说明 | 允许值 / 约束 | 示例 |
|---|---|---|---|---|---|---|
choices | 响应 JSON | array | 否 | 旧 Completion 从 choices[].text 取续写结果,不是 message.content;检查 finish_reason。 | - | - |
choices[] | 响应 JSON | object | 否 | 数组元素。 | - | - |
choices[].text | 响应 JSON | string | 否 | - | - | - |
choices[].index | 响应 JSON | integer | 否 | - | - | - |
choices[].finish_reason | 响应 JSON | string | 否 | - | - | - |
升级步骤
把 prompt 转为 messages 中的 user 内容;模型改为支持 Chat 的准确型号;输出读取从 choices[].text 改为 choices[].message.content。重新评估 max_completion_tokens 和默认采样,不逐项复制旧参数。
旧的 text_completion 与新的 chat.completion 对象名称不同。流式 delta、工具回传和多模态都是 Chat 的额外工作流。
调用示例与参考
常见错误
401:检查本站 API Key 和 Bearer 格式;403:确认此 Key 可用该模型;429:遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误,避免盲目重发;其他通用排查见聊天接入总览。