文本对话 · API
qwen3.7-plus
本平台 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.7-plus",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "请描述这张图片"
},
{
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<完整图片Base64>"
}
}
]
}
],
"max_tokens": 4096,
"stream": false
}'准备本人参考素材
素材API目前仅开放个人账户的个人Key。上传不创建生成任务。此型号可用上传格式与配置如下;参考输入的角色和数量按生成方式或对应调用组合填写,不能把接口可上传格式当作模型输入能力。使用本人同账号Key上传原文件,返回data.id后填入messages[].content[].video_asset.assetId,不能使用他人素材ID。
MP4;原文件≤2000MB;请求头X-Image-Profile: qwen35-native-video。总量与轮次按对应调用组合约束。
curl "$UNICOMP_BASE_URL/assets" \
-H "Authorization: Bearer $UNICOMP_API_KEY" \
-H "Content-Type: video/mp4" \
-H "X-Image-Profile: qwen35-native-video" \
-H "X-Model-Id: qwen3.7-plus" \
-H "X-File-Name: reference.mp4" \
--data-binary @reference.mp4{
"data": {
"id": "<本人素材ID>",
"object": "asset",
"name": "reference.mp4",
"kind": "video",
"mime_type": "video/mp4",
"bytes": "<真实文件字节数>",
"sha256": "<真实SHA256>",
"created_at": "<上传时间>",
"url": "/v1/assets/<本人素材ID>/content"
}
}按上方对应格式设置X-Image-Profile;原二进制大小按该profile及模型限制,Content-Type与实际内容必须匹配;X-File-Name为URL编码文件名。模型输入还需符合本页尺寸、格式、数量和总大小限制。上传时同时设置X-Model-Id: qwen3.7-plus,视频引用字段与fps见对应组合。 素材列表GET /v1/assets,本人素材内容GET/HEAD /v1/assets/<素材ID>/content。
字段与限制
| 字段 | 类型 | 范围 / 默认值 |
|---|---|---|
model | string | 精确使用 qwen3.7-plus |
messages | array | role/content消息数组;视频素材和fps按视频示例 |
max_tokens | number | 正整数,当前最大 65536 |
stream | boolean | 视频流式和续轮按视频示例选择 |
messages[].content[].video_asset | {assetId, source} | 本人MP4素材;source为upload或generated。最多64段,每段2–7200秒、2000MB;保持有序。 |
messages[].content[].fps | number · 可选 | 每秒采样帧数0.1–10,默认2。设置在视频内容项,不在video_asset内。 |
- max_tokens 与 max_completion_tokens 二选一,均为1–65536的整数;不能同时传入。max_completion_tokens限制完成Token总量,含返回用量中的思考Token;若限制不足以形成正文,请核查原请求结果,不自动重试。两者均未指定时平台采用本型号默认预算。
- messages为文字对话;支持stream:true时返回SSE,须收到完整finish、usage及[DONE]才确认结束。中断或未知结果应核查原请求,不能自动重新POST。
- 当前上下文 1000000 Token;输入与输出须符合本型号Token容量;请求大小限制见容量说明。响应最多32MiB,最长等待30分钟。连接中断时查询原请求,不重复提交。
- 本型号默认回复预算 4096 Token;这是平台默认值,不是模型的最大输出能力。
- 图片请求允许完整历史最多 200 条消息,每次最多 16 张PNG/JPEG dataURI图片;原图≤20MiB、边长≤8192、像素≤16777216。总输入≤20MiB;不接受远程URL。普通图片示例不混用tools;图片与工具组合仅使用本页明确列出的组合示例。
- 当前图片输入已开放SSE;须完整消费结束用量及[DONE]。
- 续轮须保留原assistant正文及存在时完整reasoning_content,并使用原Key;使用原图片素材,保持总量符合限制。
- 图片输入先按估算预留,按原请求的实际Token用量结算;估算不是模型输入上限。若返回402 VISION_BALANCE_REQUIRED,原回复和用量已保留,补足余额后使用原Key向 /v1/requests/<原请求号>/settle 发送无请求体、无查询参数的POST,取回原结果,不重新生成。请求号读取 X-Unicomp-Request-Id。
流式文字
选择已开放的纯文字组合,再添加stream:true,图片输入不使用此示例;SDK关闭自动重试,逐个消费SSE。以下为格式示意,不是实际调用结果。
{
"model": "qwen3.7-plus",
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍自己。"
}
],
"max_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]请求组合示例
示例随当前型号配置生成;请替换素材与历史消息占位内容。选择相应组合展开查看,不要混用不同组合参数。
视频与图片 · 非流式 · 单轮 · thinking
{
"model": "qwen3.7-plus",
"enable_thinking": false,
"messages": [
{
"role": "user",
"content": [
{
"type": "video_asset",
"video_asset": {
"assetId": "<本人已上传MP4素材ID>",
"source": "upload"
},
"fps": 2
},
{
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<本人完整图片Base64>"
}
},
{
"type": "text",
"text": "请描述视频的主要内容。"
}
]
}
],
"stream": false,
"max_tokens": 512
}- 使用同一密钥向 /v1/assets 上传完整MP4,设置X-Image-Profile: qwen35-native-video、X-Model-Id: qwen3.7-plus、Content-Type: video/mp4、X-File-Name: URL编码文件名;取得data.id后填写video_asset.assetId。
- 视频最多64段,每段2–7200秒、≤2000MB。fps设置在视频内容项,范围0.1–10,默认2;仅本人素材或已审核作品,不传远程视频URL。
- 输出预算最多65536 Token;视频音轨不作为音频理解。图片混合输入使用PNG/JPEG完整Base64,最多16张、总量20MiB;文字、图片与视频保持原顺序。
- 本示例为单轮;需要续轮时选择对应历史组合。
- 按实际Token用量结算;保存原请求号,未知结果查询 /v1/requests/<原请求号>,补足余额后结算原单。
视频理解 · 非流式 · 单轮 · thinking
{
"model": "qwen3.7-plus",
"enable_thinking": false,
"messages": [
{
"role": "user",
"content": [
{
"type": "video_asset",
"video_asset": {
"assetId": "<本人已上传MP4素材ID>",
"source": "upload"
},
"fps": 2
},
{
"type": "text",
"text": "请描述视频的主要内容。"
}
]
}
],
"stream": false,
"max_tokens": 512
}- 使用同一密钥向 /v1/assets 上传完整MP4,设置X-Image-Profile: qwen35-native-video、X-Model-Id: qwen3.7-plus、Content-Type: video/mp4、X-File-Name: URL编码文件名;取得data.id后填写video_asset.assetId。
- 视频最多64段,每段2–7200秒、≤2000MB。fps设置在视频内容项,范围0.1–10,默认2;仅本人素材或已审核作品,不传远程视频URL。
- 输出预算最多65536 Token;视频音轨不作为音频理解。图片混合输入使用PNG/JPEG完整Base64,最多16张、总量20MiB;文字、图片与视频保持原顺序。
- 本示例为单轮;需要续轮时选择对应历史组合。
- 按实际Token用量结算;保存原请求号,未知结果查询 /v1/requests/<原请求号>,补足余额后结算原单。
支持的能力
使用下方调用示例选择参数组合;请求结果和费用可在用量记录中查看。
调用参数和限制见本页示例。
| 能力 | 状态 | 使用方法 |
|---|---|---|
| 函数工具 | 支持 | 发送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;收到完整结束事件后读取用量。连接中断时查询原请求,避免重复提交。 |
| 图片理解 | 支持 | 最多16张PNG/JPEG;可保留历史续轮;支持流式。详细大小限制见图片示例。 |
| 视频理解 | 支持 | 使用本人MP4素材ID;上传配置、大小、轮次和流式设置见下方视频示例。 |
| 长度与输出预算 | 支持 | 上下文1,000,000 Token;输出最多65,536 Token;默认4096。 |
当前价格
接口金额使用整数微元:1元 = 1,000,000微元。按报价和实际用量结算。
| 规格 | 计价项 | 人民币单价 |
|---|---|---|
| 输入≤256000 Token | 百万输入 token | ¥3.2/百万输入 token |
| 输入≤256000 Token | 百万缓存输入 token | ¥0.64/百万缓存输入 token |
| 输入≤256000 Token | 百万输出 token | ¥12.8/百万输出 token |
| 基础档位 | 百万输入 token | ¥9.6/百万输入 token |
| 基础档位 | 百万缓存输入 token | ¥1.92/百万缓存输入 token |
| 基础档位 | 百万输出 token | ¥38.4/百万输出 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检查型号或服务状态。