文档

Responses格式

更新时间:2026-11-04

POST
/v1/responses

OpenAI Responses API,用于创建模型响应。支持多轮对话、工具调用、推理等功能。

身份验证

BearerAuth
headerAuthorizationBearer <token>

使用 API Key 认证,格式:Authorization: Bearer <token>。

请求体

application/json
  1. body
model*string

模型 ID。

input?|array<>

输入内容,可以是字符串或消息数组。

instructions?string

系统指令(相当于 ChatCompletions 中的 system 消息)。

max_output_tokens?integer

最大输出 Token 数。

temperature?number

采样温度。

top_p?number

核采样参数。

stream?boolean

是否流式响应。

tools?array<>

工具定义。

tool_choice?|

工具选择策略。

reasoning?

推理配置。

previous_response_id?string

上一轮响应 ID,用于衔接多轮对话上下文。

truncation?string

截断策略。

可选值"auto""disabled"

响应体

成功创建响应

application/json
  1. response
id?string

响应 ID。

object?string

对象类型。

created_at?integer

创建时间,Unix 时间戳(秒)。

status?string

响应状态。

model?string

实际使用的模型 ID。

output?array<>

输出项列表。

usage?

Token 用量统计。

请求示例
curl -X POST 'https://vod.gz.baidubce.com/v1/responses' \  -H 'Content-Type: application/json' \  -d '{  "model": "kimi-k3"}'
响应示例200
{  "id": "string",  "object": "string",  "created_at": 0,  "status": "string",  "model": "string",  "output": [    {      "type": "string",      "id": "string",      "status": "string",      "role": "string",      "content": [        {          "type": "string",          "text": "string"        }      ]    }  ],  "usage": {    "prompt_tokens": 0,    "completion_tokens": 0,    "total_tokens": 0,    "prompt_tokens_details": {      "cached_tokens": 0,      "text_tokens": 0,      "audio_tokens": 0,      "image_tokens": 0    },    "completion_tokens_details": {      "text_tokens": 0,      "audio_tokens": 0,      "reasoning_tokens": 0    }  }}