跳到主要内容

创建 Response

POST /responses

创建一个 Response。Responses API 由服务端托管对话状态,通过 previous_response_id 串联多轮上下文。

Request​

  • application/json

Body​

model string · required

Possible values: [SpAk-Aster-V1-MOE]

使用的模型的 ID。

input string | array · required

输入内容,可以是纯文本,也可以是消息数组。

previous_response_id string · nullable

上一轮 Response 的 ID。传入后服务端会自动携带之前的上下文。

thinking

object · nullable

控制思考模式与非思考模式的转换。

type string

Possible values: [enabled, disabled]

Default value: enabled

reasoning_effort string

Possible values: [high, max]

控制模型的推理强度。

stream boolean · nullable

如果设置为 true,将会以 SSE(server-sent events)的形式流式发送增量。

Responses​

  • 200

OK, 返回 response 对象。

Schema

id string · required

该 Response 的唯一标识符,可用于 previous_response_id。

output object[] · required

模型输出项列表,包含 message 输出项(content)与 reasoning 输出项(思维链内容)。

model string · required

生成该 Response 的模型名。

usage

object

该请求的用量信息,字段与对话补全一致。

object string · required

Possible values: [response]