文档

Responses格式

更新时间:2026-11-11

请求方法与路径

POST
/v1/responses

身份验证

详见调用指南 - 鉴权。

请求头参数

详见调用指南 - 公共请求头。

请求体

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://api.cysuo.com/v1/responses' \  -H 'Content-Type: application/json' \  -d '{  "model": "deepseek-v4-flash",  "input": "你好,请介绍一下你自己。"}'
响应示例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": {    "input_tokens": 0,    "input_tokens_details": {      "cached_tokens": 0    },    "output_tokens": 0,    "output_tokens_details": {      "reasoning_tokens": 0    },    "total_tokens": 0  }}