文本对话 · API
qwen3-32b
本平台 OpenAI 风格 JSON(重排为平台扩展)
调用示例
正式 Base URL 为 https://www.unicompapi.com/v1;设置 UNICOMP_BASE_URL 与 UNICOMP_API_KEY 后替换素材与 Base64 占位内容。新请求使用 REQUEST_KEY,响应 X-Unicomp-Request-Id 保存为 REQUEST_ID;两者用于查询同一原单。
POST /v1/chat/completions
# 仅用于新请求;未知结果时查询原单,不重新执行本段
# 需要 Python 3;保存打印的 REQUEST_KEY
REQUEST_KEY="$(python3 -c 'import uuid; print(uuid.uuid4())')"
[ -n "$REQUEST_KEY" ] || exit 1 # UUID生成失败时停止
printf 'REQUEST_KEY=%s\n' "$REQUEST_KEY"
curl "$UNICOMP_BASE_URL/chat/completions" \
-H "Authorization: Bearer $UNICOMP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $REQUEST_KEY" \
--data '{
"model": "qwen3-32b",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
}
],
"max_completion_tokens": 4096
}'字段与限制
| 字段 | 类型 | 范围 / 默认值 |
|---|---|---|
model | string | 精确使用 qwen3-32b |
messages | array | role/content消息数组;图片输入按本页示例 |
max_completion_tokens | number | 正整数,当前最大 32768 |
- max_tokens 与 max_completion_tokens 二选一,均为1–32768的整数;不能同时传入。max_completion_tokens限制完成Token总量,含返回用量中的思考Token;若限制不足以形成正文,请核查原请求结果,不自动重试。两者均未指定时平台采用本型号默认预算。
- messages为文字对话;支持stream:true时返回SSE,须收到完整finish、usage及[DONE]才确认结束。中断或未知结果应核查原请求,不能自动重新POST。
- 本型号默认回复预算 4096 Token;这是平台默认值,不是模型的最大输出能力。
- 此接口使用文字消息,不接受image_url。
流式文字
选择已开放的纯文字组合,再添加stream:true,图片输入不使用此示例;SDK关闭自动重试,逐个消费SSE。以下为格式示意,不是实际调用结果。
{
"model": "qwen3-32b",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
}
],
"max_completion_tokens": 4096,
"stream": true
}data: {"choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}
data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":8,"completion_tokens":2,"total_tokens":10}}
data: [DONE]请求组合示例
示例随当前型号配置生成;请替换素材与历史消息占位内容。选择相应组合展开查看,不要混用不同组合参数。
参数组合:tools · 流式
{
"model": "qwen3-32b",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
}
],
"max_completion_tokens": 4096,
"tool_choice": "auto",
"stream": true,
"tools": [
{
"type": "function",
"function": {
"name": "get_demo_value",
"description": "由客户端读取演示值",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
}
]
}- 使用示例中的参数组合。JSON Schema按本页支持的关键词填写;客户端校验JSON正文,reasoning_content单独读取。
工具结果显式续轮
{
"model": "qwen3-32b",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
},
{
"role": "assistant",
"content": null,
"tool_calls": [
{
"id": "<原tool_call_id>",
"type": "function",
"function": {
"name": "get_demo_value",
"arguments": "{\"city\":\"北京\"}"
}
}
],
"reasoning_content": "<原响应存在时原样保留,否则省略>"
},
{
"role": "tool",
"tool_call_id": "<原tool_call_id>",
"content": "{\"value\":1}"
}
],
"max_completion_tokens": 4096,
"tool_choice": "auto",
"stream": true,
"tools": [
{
"type": "function",
"function": {
"name": "get_demo_value",
"description": "由客户端读取演示值",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
}
]
}- 将示例占位内容替换为原响应。用实际原assistant/tool_calls替换;客户端验证参数后执行工具,再返回同tool_call_id;每轮新请求独立计费,不自动循环。
参数组合:tools · 非流式
{
"model": "qwen3-32b",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
}
],
"max_completion_tokens": 4096,
"tool_choice": "auto",
"stream": false,
"tools": [
{
"type": "function",
"function": {
"name": "get_demo_value",
"description": "由客户端读取演示值",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
}
]
}- 使用示例中的参数组合。JSON Schema按本页支持的关键词填写;客户端校验JSON正文,reasoning_content单独读取。
支持的能力
使用下方调用示例选择参数组合;请求结果和费用可在用量记录中查看。
调用参数和限制见本页示例。
| 能力 | 状态 | 使用方法 |
|---|---|---|
| 函数工具 | 支持 | 发送tools定义;收到tool_calls后由客户端执行工具,并返回匹配tool_call_id的tool消息。 |
| 思考 | 暂不提供 | 按示例设置思考参数;续轮保留原响应中的reasoning_content。 |
| JSON Object | 暂不提供 | 发送response_format.type="json_object",并在提示词中说明JSON要求。 |
| JSON Schema | 暂不提供 | 发送response_format.type="json_schema"及本页示例支持的Schema;JSON正文与思考内容分别读取。 |
| 完整历史 | 支持 | 在messages中保留完整对话;工具续轮同时保留assistant.tool_calls及对应tool消息。 |
| 流式回复 | 支持 | 设置stream=true;收到完整结束事件后读取用量。连接中断时查询原请求,避免重复提交。 |
| 图片理解 | 暂不提供 | 请使用文字消息。 |
| 视频理解 | 暂不提供 | 此接口不接受视频、音频或文件消息。 |
| 长度与输出预算 | 支持 | 输出最多32,768 Token;默认4096。 |
当前价格
接口金额使用整数微元:1元 = 1,000,000微元。按报价和实际用量结算。
| 规格 | 计价项 | 人民币单价 |
|---|---|---|
| 基础档位 | 百万输入 token | ¥2.4/百万输入 token |
| 基础档位 | 百万缓存输入 token | ¥0/百万缓存输入 token |
| 基础档位 | 百万输出 token | ¥24/百万输出 token |
响应与结果
非流式响应choices[].message.content和usage;文字stream:true返回text/event-stream delta、finish与[DONE]。OCR只支持非流式。
保存Idempotency-Key和X-Unicomp-Request-Id。使用请求号查询状态与费用,客户端禁自动重试未知请求;401核Key,400核字段,402核余额,409核幂等或报价变化,503检查型号或服务状态。