对话 (Chat) API

标准化多轮对话接口，兼容 OpenAI 规范，支持 Function Calling 与多模态输入

POST /v1/chat/completions

对话 (Chat Completions)

cURL

curl --request POST \
  --url https://api.senseaudio.cn/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "senseaudio-s2",
  "messages": [
    {
      "role": "system",
      "content": "你是一个严谨的人工智能助手。"
    },
    {
      "role": "user",
      "content": "你好，请解释一下什么是黑洞？"
    }
  ],
  "temperature": 0.7,
  "stream": false
}
'

200

{
  "id": "chatcmpl-1234567890",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "senseaudio-s2",
  "system_fingerprint": "fp_xxxxxx",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "黑洞是宇宙中存在的一种天体，其引力极强..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 105,
    "total_tokens": 133
  }
}

​

说明

提供标准化的对话接口，兼容主流规范，支持多轮对话、工具调用 (Function Calling) 及多模态输入。

• 接口地址：POST https://api.senseaudio.cn/v1/chat/completions
• 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。

messages · object[] · 必填

包含历史对话上下文和当前输入的消息列表。

显示 child attributes

messages.role · string · 必填

发送消息的角色：system / user / assistant / tool。

messages.content · string | object[] · 必填

消息内容。文本形式直接传字符串；多模态形式传对象数组（如图片 URL）。

messages.name · string

参与者的名称，用于向模型提供特定的身份标识。

messages.tool_calls · object[]

仅当 role="assistant" 时可能出现，表示触发的工具调用列表。

messages.tool_call_id · string

仅当 role="tool" 时必填，表示该条执行结果对应的工具调用请求 ID。

tools · object[]

模型可调用的工具列表，主要用于 Function Calling 场景。

显示 child attributes

tools.type · string · 必填

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

tools.function · object · 必填

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

tool_choice · string | object · 默认值: "auto"

控制模型调用工具的行为：none / auto / required，或指定函数对象 {type: 'function', function: {name: 'my_func'}}。

stream · boolean · 默认值: "false"

是否开启流式响应，开启后通过 SSE 协议逐块返回。

stream_options · object

流式响应选项（仅 stream=true 时有效）。

显示 child attributes

stream_options.include_usage · boolean · 默认值: "false"

若为 true，会在终止块 [DONE] 前返回包含 usage 的最后一个 chunk。

response_format · object

输出格式：{type: 'text'}（默认）、{type: 'json_object'}（强制 JSON）。

max_tokens · integer

限制生成的最大 token 数量。不设置则直至自然生成完毕或达到模型上限。

temperature · number · 默认值: "1.0"

采样温度，范围 [0.0, 2.0]。值越高输出越随机，建议与 top_p 二选一调整。

top_p · number · 默认值: "1.0"

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

n · integer · 默认值: "1"

为每条输入消息生成的回复选项数量。

stop · string | string[]

停止词序列（最多 4 个）。

frequency_penalty · number · 默认值: "0.0"

频率惩罚系数，范围 [-2.0, 2.0]。

presence_penalty · number · 默认值: "0.0"

存在惩罚系数，范围 [-2.0, 2.0]。

logit_bias · object

调整特定 token 出现的概率。键为 Token ID，值为偏差 [-100, 100]。

logprobs · boolean · 默认值: "false"

是否返回输出 token 的对数概率。

top_logprobs · integer

返回在每个位置最可能的 N 个 token 的概率（需开启 logprobs，范围 [0, 20]）。

seed · integer

随机种子，用于尽可能的确定性采样。

user · string

最终用户的唯一标识，可用于协助监控及防滥用。

​

Response

200 — application/json

id · string

本次请求的唯一标识符。

object · string

对象类型。非流式为 "chat.completion"；流式为 "chat.completion.chunk"。

created · integer

生成成功的 Unix 时间戳（秒）。

model · string

实际响应的模型名称。

system_fingerprint · string

模型运行的后端配置系统指纹。

choices · object[]

模型生成的回复选项列表。

显示 child attributes

choices.index · integer

在数组中的索引下标。

choices.finish_reason · string

停止原因：stop / length / tool_calls / content_filter。

choices.message · object

模型返回的消息对象（非流式）。

显示 message fields

message.role · string

始终为 "assistant"。

message.content · string

文本回复内容（仅调用工具时可能为空）。

message.tool_calls · object[]

决定的工具调用列表，包含 id、type、function。

choices.delta · object

流式模式下替代 message，增量内容对象（含 role / content / tool_calls 增量）。

usage · object

Token 消耗统计。

显示 child attributes

usage.prompt_tokens · integer

提示词消耗。

usage.completion_tokens · integer

补全结果消耗。

usage.total_tokens · integer

总消耗。

​

流式响应示例

开启 stream: true 时，基于 SSE 协议逐块返回：

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1700000000,"model":"senseaudio-s2","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1700000000,"model":"senseaudio-s2","choices":[{"index":0,"delta":{"content":"黑洞"},"finish_reason":null}]}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1700000000,"model":"senseaudio-s2","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

​

错误处理

错误时返回非 200 状态码，响应体包含 error 对象：

error · object

错误对象。

显示 child attributes

error.message · string

错误的人类可读描述。

error.type · string

错误类别（如 invalid_request_error）。

error.code · string

固定错误码的内部代号。

error.param · string

触发该错误的对应参数名。

​

相关指南

• 文本生成介绍
• 模型响应 (Responses) API
• 消息 (Messages)
• 计费说明

授权

Authorization · string · header · 必填

格式：Bearer <API_KEY>

请求体

application/json

model · enum<string> · 默认值: senseaudio-s2 · 必填

可用选项: deepseek-v4-flash, deepseek-v4-pro, doubao-seed-2-0-code-preview-260215, doubao-seed-2-0-lite-260215, doubao-seed-2-0-mini-260215, doubao-seed-2-0-pro-260215, glm-5.1, kimi-k2.6, minimax-m2.7, qwen3.6-27b, qwen3.6-35b-a3b, senseaudio-s2, senseaudio-s2-flash, senseaudio-s2-lite, senseaudio-vl-1.0-260319, senseaudio-vl-lite-1.0-260319, sensenova-6.7-flash-lite

示例:

"senseaudio-s2"

messages · object[] · 必填

Show child attributes

tools · object[]

tool_choice · any

字段推断自素材文档

stream · boolean · 默认值: false

stream_options · object

response_format · object

max_tokens · integer

示例:

1024

temperature · number

示例:

0.7

top_p · number

示例:

1

响应

200 - application/json

成功

字段推断自素材文档（兼容 OpenAI）

id · string

object · string

created · integer

model · string

choices · object[]

usage · object