基础调用
入口为POST /v1/responses,使用 Bearer 鉴权和支持 responses 的模型。下面示例不保存平台响应内容。
流式输出
设置stream: true 并逐事件处理,不把 SSE 直接当作 JSON。复用示例中的 client:
保存与续接
store=true 默认保留 30 天。保存响应 ID;同一用户且具有模型权限时,可在原区域使用 GET /v1/responses/RESPONSE_ID 查询、GET /v1/responses/RESPONSE_ID/input_items 查看输入,再通过 previous_response_id 续接。
store=false 不保存平台内容副本,不能通过 HTTP 查询或续接;仅同一 WebSocket 连接内保留可续接历史。后台执行要求 store=true。
后台执行与取消
渠道支持background 时,可使用 background: true, store: true 提交,轮询已保存的响应状态。取消后台响应:
DELETE /v1/responses/RESPONSE_ID 会取消执行、阻止后续查询和续接并移除内容,财务记录仍保留。取消或断连不能保证零用量。
其他能力
POST /v1/responses/compact、POST /v1/responses/input_tokens 与 WebSocket GET /v1/responses 取决于渠道能力。compact 计费,token 计数不收生成费用。事件恢复可使用 stream、starting_after 查询参数;必须继续使用原响应所在区域。