字段与用途

字段路径位置类型必填填写规则与说明允许值 / 约束示例
choices响应 JSONarray否流式候选数组。按 index 聚合 delta；内容和工具 arguments 都可能拆成多片，finish_reason 不是正文。--
choices[]响应 JSONobject否数组元素。--
choices[].index响应 JSONinteger否---
choices[].delta响应 JSONobject否---
choices[].delta.role响应 JSONstring否---
choices[].delta.content响应 JSONstring否---
choices[].delta.reasoning_content响应 JSONstring否---
choices[].delta.tool_calls响应 JSONarray<object>否---
choices[].delta.tool_calls[]响应 JSONobject否数组元素。--
choices[].delta.tool_calls[].id响应 JSONstring否---
choices[].delta.tool_calls[].type响应 JSONstring否---
choices[].delta.tool_calls[].function响应 JSONobject否---
choices[].delta.tool_calls[].function.name响应 JSONstring否---
choices[].delta.tool_calls[].function.arguments响应 JSONstring否---
choices[].finish_reason响应 JSONstring否---
usage响应 JSONobject否用量对象，可能因协议/流式缺失。prompt_tokens / completion_tokens / total_tokens；推理详情按模型返回。--
usage.prompt_tokens响应 JSONinteger否提示词 Token 数--
usage.completion_tokens响应 JSONinteger否补全 Token 数--
usage.total_tokens响应 JSONinteger否总 Token 数--
usage.prompt_tokens_details响应 JSONobject否---
usage.prompt_tokens_details.cached_tokens响应 JSONinteger否---
usage.prompt_tokens_details.text_tokens响应 JSONinteger否---
usage.prompt_tokens_details.audio_tokens响应 JSONinteger否---
usage.prompt_tokens_details.image_tokens响应 JSONinteger否---
usage.completion_tokens_details响应 JSONobject否---
usage.completion_tokens_details.text_tokens响应 JSONinteger否---
usage.completion_tokens_details.audio_tokens响应 JSONinteger否---
usage.completion_tokens_details.reasoning_tokens响应 JSONinteger否---

SSE 使用 Content-Type: text/event-stream。按空行分隔事件，合并同一事件内多条 data 行后再解析 JSON；网络 chunk 可能跨 UTF-8 字符和事件。按 choices[].index 拼接 delta.content；工具参数按 delta.tool_calls[].index 累加，全部收齐后才解析 JSON。choices=[] 的用量事件合法。data: [DONE] 表示传输结束，还要检查各候选 finish_reason。断线没有通用续传或查询入口。

结构示意

data: {"choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

示意省略可选字段。delta.role 可能只在首片出现，content 可能缺失。先按工具 index 汇总 arguments，再在工具结束后 JSON.parse；不要逐片执行。

调用示例与参考

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

常见错误

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