聊天（Chat）
Responses 格式
创建 Responses 响应，适合 Codex、工具调用、多轮任务、结构化输出和新版 OpenAI 客户端。
POST
/v1/responsesAuthorizationBearerAuth
BearerAuth
使用 Bearer Token 认证。
Authorization: Bearer sk-xxxxxx使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。
Bodyapplication/json
modelrequired模型名称。建议先调用模型列表确认可用模型。
模型输入。可以是简单字符串，也可以是包含 role/content 的结构化输入。
字段结构
rolestring输入项角色，例如 user、assistant、system。
contentstring | array<object>输入内容，可为文本或多模态内容块。
instructions开发者指令或系统提示。
stream是否启用流式响应。
previous_response_id多轮响应续接时使用。
max_output_tokens最大输出 Token。
Authorization
BearerAuth请求头使用 Authorization，值为 Bearer <token>。 Token 来自控制台“API 密钥”，不是登录态，也不是管理员密钥。
In: header
Request Body
application/jsonmodelrequired模型名称。建议先调用模型列表确认可用模型。
inputrequired模型输入。可以是简单字符串，也可以是包含 role/content 的结构化输入。
instructions开发者指令或系统提示。
tools工具定义。
stream是否启用流式响应。
previous_response_id多轮响应续接时使用。
max_output_tokens最大输出 Token。
Response Body
application/jsonidResponse ID。
status响应状态，例如 completed。
output结构化输出数组。
output_text便于直接读取的文本输出。
usageToken 使用统计。
说明
该接口同时支持 /responses、/responses/*subpath 和 /backend-api/codex/responses 兼容入口。常规客户端优先使用 /v1/responses。