跳转到主要内容
POST
/
v1
/
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-vl-1.0-260319",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": "请解释一下什么是闭包。"
    }
  ],
  "stream": false
}
'
{
  "id": "resp_abc123",
  "object": "response",
  "created": 1700000000,
  "model": "senseaudio-vl-1.0-260319",
  "status": "completed",
  "output": {
    "type": "message",
    "role": "assistant",
    "content": "闭包是指那些能够访问自由变量的函数..."
  },
  "usage": {
    "input_tokens": 51,
    "output_tokens": 149,
    "total_tokens": 200
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt

Use this file to discover all available pages before exploring further.

说明

通用模型生成接口,支持结构化输入输出,适用于更底层、更复杂的逻辑控制与推理场景。
  • 接口地址POST https://api.senseaudio.cn/v1/responses
  • Content-Typeapplication/json
  • 鉴权方式:Bearer Token,详见 快速接入
  • 流式输出stream: true 以 SSE 协议逐块返回;收到 data: [DONE] 标识流结束
  • 模型列表:见 模型列表
  • 计费:按输入 / 输出 token 计费,详见 计费说明

Authorizations

Authorization
string
必填
Bearer 鉴权头,格式为 Bearer SENSEAUDIO_API_KEY

Body

application/json
model
string
必填
调用的模型名称,例如 senseaudio-vl-1.0-260319
input
string | object[]
必填
输入内容。字符串视为一条纯文本用户消息;数组则是包含多个输入元素的列表。
tools
object[]
模型可调用的工具列表。
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

200application/json
id
string
本次响应的唯一标识符。
object
string
对象类型,固定为 "response"
created
integer
响应创建的 Unix 时间戳(秒)。
model
string
实际响应的模型名称。
status
string
请求状态:completed / in_progress / incomplete
output
object
模型生成的核心内容对象。
usage
object
Token 消耗统计。

流式响应示例

开启 stream: true 时,SSE 协议逐块返回,数据块前缀 data:
data: {"object":"response.chunk","output":{"content":"闭包"}}

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

data: [DONE]
流式 output 字段:content(文本片段)/ arguments(工具调用参数片段)。

错误处理

error
object
错误对象。

相关指南

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

请求体

application/json

字段推断自素材文档

model
enum<string>
默认值:senseaudio-vl-1.0-260319
必填

调用的模型名称,请以模型列表为准。

可用选项:
senseaudio-vl-1.0-260319,
senseaudio-vl-lite-1.0-260319
示例:

"senseaudio-vl-1.0-260319"

input
any
必填

字符串或消息数组

instructions
string
示例:

"你是一个严谨的人工智能助手。"

stream
boolean
示例:

false

max_output_tokens
integer
示例:

1024

响应

200 - application/json

成功

字段推断自素材文档

id
string
object
string
output
object[]
usage
object