模型响应 (Responses) API

Responses API

curl --request POST \
  --url https://api.senseaudio.cn/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "senseaudio-s2",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": "请解释一下什么是闭包。"
    }
  ],
  "stream": false
}
'

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1700000000,
  "model": "senseaudio-s2",
  "status": "completed",
  "output": {
    "type": "message",
    "role": "assistant",
    "content": "闭包是指那些能够访问自由变量的函数..."
  },
  "usage": {
    "input_tokens": 51,
    "output_tokens": 149,
    "total_tokens": 200
  }
}

POST

responses

Responses API

curl --request POST \
  --url https://api.senseaudio.cn/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "senseaudio-s2",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": "请解释一下什么是闭包。"
    }
  ],
  "stream": false
}
'

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1700000000,
  "model": "senseaudio-s2",
  "status": "completed",
  "output": {
    "type": "message",
    "role": "assistant",
    "content": "闭包是指那些能够访问自由变量的函数..."
  },
  "usage": {
    "input_tokens": 51,
    "output_tokens": 149,
    "total_tokens": 200
  }
}

说明

通用模型生成接口，支持结构化输入输出，适用于更底层、更复杂的逻辑控制与推理场景。

接口地址：POST https://api.senseaudio.cn/v1/responses
Content-Type：application/json
鉴权方式：Bearer Token，详见快速接入
流式输出：stream: true 以 SSE 协议逐块返回；收到 data: [DONE] 标识流结束
模型列表：见模型列表
计费：按输入 / 输出 token 计费，详见计费说明

Authorizations

Authorization

string

必填

Bearer 鉴权头，格式为 Bearer SENSEAUDIO_API_KEY。

Body

application/json

model

string

必填

调用的模型名称，例如 senseaudio-s2。

input

string | object[]

必填

输入内容。字符串视为一条纯文本用户消息；数组则是包含多个输入元素的列表。

显示数组元素类型

input[].type

string

元素类型：message / input_text / input_image / function_call / function_call_output。

input[].role

string

仅 message：发送者角色（system / user / assistant）。

input[].content

string | object[]

仅 message：文本或多模态对象数组。

input[].text

string

仅 input_text：文本内容。

input[].image_url

string

仅 input_image：图片 URL 或 base64 (data URL)。

input[].detail

string

仅 input_image：low / high / auto。

input[].name

string

仅 function_call：工具函数名。

input[].call_id

string

仅 function_call / function_call_output：调用的唯一 ID。

input[].arguments

string

仅 function_call：JSON 格式的函数参数。

input[].output

string

仅 function_call_output：工具执行后返回的输出结果。

tools

object[]

模型可调用的工具列表。

显示 child attributes

tools.type

string

必填

工具类型。当前为 "function"。

tools.function

object

必填

函数工具定义对象，包含 name、description、parameters（JSON Schema）。

tool_choice

string | object

默认值:"auto"

控制模型调用工具的行为：none / auto / required，或指定函数对象。

stream

boolean

默认值:"false"

是否开启 SSE 流式返回。

temperature

number

默认值:"1.0"

采样温度，范围 [0.0, 2.0]。

top_p

number

默认值:"1.0"

核采样概率阈值，范围 [0.0, 1.0]。

max_tokens

integer

限制生成的最大 token 数量。

response_format

object

输出格式：{type: 'json_object'}（强制 JSON）或 {type: 'json_schema', json_schema: {...}}（结构化输出）。

Response

200 — application/json

string

本次响应的唯一标识符。

object

string

对象类型，固定为 "response"。

created

integer

响应创建的 Unix 时间戳（秒）。

model

string

实际响应的模型名称。

status

string

请求状态：completed / in_progress / incomplete。

output

object

模型生成的核心内容对象。

显示 child attributes

output.type

string

输出类别：message / function_call / reasoning。

output.role

string

仅 message 时存在，始终为 "assistant"。

output.content

string | object[]

仅 message 时存在，生成的回复内容。

output.name

string

仅 function_call 时存在，模型决定调用的目标函数名。

output.arguments

string

仅 function_call 时存在，生成的函数参数（JSON 字符串）。

output.call_id

string

仅 function_call 时存在，生成的唯一调用标识符。

output.summary

string[]

仅 reasoning 时存在，内部思维链推进过程的文本数组。

usage

object

Token 消耗统计。

显示 child attributes

usage.input_tokens

integer

提示内容消耗。

usage.output_tokens

integer

生成结果消耗。

usage.total_tokens

integer

总消耗统计。

流式响应示例

开启 stream: true 时，SSE 协议逐块返回，数据块前缀 data: ：

data: {"object":"response.chunk","output":{"content":"闭包"}}

data: {"object":"response.chunk","output":{"content":"是指那些..."}}

data: [DONE]

流式 output 字段：content（文本片段）/ arguments（工具调用参数片段）。

错误处理

error

object

错误对象。

显示 child attributes

error.message

string

错误详细描述。

error.type

string

错误类型（如 invalid_request_error）。

error.code

string

内部错误代码。

error.param

string

导致错误的对应参数名。

说明

Authorizations

Body

Response

流式响应示例

错误处理

相关指南

授权

请求体

响应

Documentation Index

​说明

​Authorizations

​Body

​Response

​流式响应示例

​错误处理

​相关指南

授权

请求体

响应

说明

Authorizations

Body

Response

流式响应示例

错误处理

相关指南