文档

文本生成(Responses)

使用 OpenAI Responses 格式生成文本与调用工具

POSThttps://api.tokenbyte.ai/v1/responses

Header 参数

参数必填说明
AuthorizationBearer <TOKENBYTE_API_KEY>
Content-Typeapplication/json

Body 参数

参数类型必填说明
modelstring支持 Responses 协议的完整模型 ID
inputstring/array纯文本或结构化消息与工具结果
instructionsstring本次请求的系统级指令
previous_response_idstring关联上一响应以继续对话
streamboolean是否返回语义化 SSE 事件
storeboolean是否保存响应以供后续引用
toolsarray可用工具,取决于模型与渠道
tool_choicestring/object控制模型是否及如何调用工具
temperaturenumber采样随机度
top_pnumber核采样概率阈值
reasoningobject模型支持时设置推理强度

input 使用数组时可承载 messagefunction_call_output 等结构化项目。工具调用通常在 output 中以 function_call 项返回,应用执行后将结果作为下一次请求的输入。

响应

非流式响应的 output 是有序输出项数组。最终文本通常位于 output[].content[] 中的 output_text 项;请不要假设 output[0] 一定是文本。

流式请求设置 stream: true。常见事件包括 response.createdresponse.output_text.deltaresponse.completederror