import os
import dashscope
client = dashscope.Client(
api_key=os.getenv('DASHSCOPE_API_KEY'),
base_url='https://maas.qianwenaiapi.com/api/v1',
)
messages = [
{'role': 'system', 'content': 'You are a helpful assistant.'},
{'role': 'user', 'content': 'Who are you?'}
]
response = client.chat.completions.create(
model='qwen-plus',
messages=messages,
)
print(response){
"status_code": 200,
"request_id": "902fee3b-f7f0-9a8c-96a1-6b4ea25af114",
"code": "",
"message": "",
"output": {
"text": null,
"finish_reason": null,
"choices": [
{
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": "I am a large-scale language model developed by Alibaba Cloud. My name is Qwen.",
"tool_calls": null,
"reasoning_content": null
}
}
]
},
"usage": {
"input_tokens": 22,
"output_tokens": 17,
"total_tokens": 39,
"image_tokens": null,
"video_tokens": null,
"audio_tokens": null
}
}接口地址
- HTTP(纯文本模型,如
qwen-plus):POST https://maas.qianwenaiapi.com/api/v1/services/aigc/text-generation/generation - HTTP(多模态模型,如
qwen3.7-plus、qwen3-vl-plus):POST https://maas.qianwenaiapi.com/api/v1/services/aigc/multimodal-generation/generation - SDK
base_http_api_url:https://maas.qianwenaiapi.com/api/v1
dashscope.base_http_api_url = 'https://maas.qianwenaiapi.com/api/v1'
// 方式一:实例化时指定
import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://maas.qianwenaiapi.com/api/v1");
// 方式二:全局设置
import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl = "https://maas.qianwenaiapi.com/api/v1";
鉴权
千问AI平台 API Key。详见获取 API Key。
Header 参数
在平台内置内容安全能力的基础上,可通过 AI 安全护栏进一步识别输入输出内容中的违规信息。参数值为 JSON 字符串,input 和 output 分别对应输入和输出,取值为 cip 时使用 AI 安全护栏进一步识别该方向的违规信息,可分别设置:
'{"input":"cip","output":"cip"}':输入和输出均使用 AI 安全护栏进一步识别'{"input":"cip"}':仅对输入使用 AI 安全护栏进一步识别'{"output":"cip"}':仅对输出使用 AI 安全护栏进一步识别- 不设置该参数:不启用 AI 安全护栏
HTTP 调用时放入请求头:-H "X-DashScope-DataInspection: {\"input\": \"cip\", \"output\": \"cip\"}";Python SDK 调用时通过 headers 配置:headers={'X-DashScope-DataInspection': '{"input":"cip","output":"cip"}'}。
详见安全。
请求体
application/jsonqwen4-max 需使用多模态端点 /api/v1/services/aigc/multimodal-generation/generation,即使只传入文本也不使用本接口。
调用的模型名称。支持 Qwen 大语言模型(商业版和开源版)、Qwen-Coder、数学模型、DeepSeek(阿里云直供、硅基流动直供)、Kimi(阿里云直供)、GLM(阿里云直供)、MiniMax(阿里云直供、稀宇科技直供)。模型列表详见文本生成 — Qwen。
文本模型的可选生成参数。
显示子属性
显示子属性
返回数据的格式。多轮对话时请设为 message。
**默认值:**大多数模型默认为 text,但 Qwen3-VL、QwQ 和 Qwen3 开源模型默认为 message。
使用 Qwen-VL/QVQ 模型时,设为 text 不生效。Qwen3-VL 和 Qwen3 模型在思考模式下只能设为 message。
qwen4-max:思考模式文本、图像、视频均默认 1.0;非思考模式默认 0.7。qwen3.8-max 的视觉温度最低按 0.6 处理规则不适用于本模型。
采样温度。控制输出的多样性。较高的值使输出更多样化,较低的值使输出更确定。取值范围:[0, 2)。
QVQ 模型请勿修改默认温度值。
默认 temperature 值:
qwen3.8-max、qwen3.8-flash(思考模式):视觉理解输入为 0.6,文本输入为 1.0;传入小于 0.6 的值会自动调整为 0.6- Qwen3.8(非思考模式)、Qwen3.7(非思考模式)、Qwen3.6(非思考模式)、Qwen3.5(非思考模式)、Qwen3(非思考模式)、Qwen3-Instruct 系列、Qwen3-Coder 系列、qwen-max 系列、qwen-plus 系列(非思考模式)、qwen-flash 系列(非思考模式)、qwen 开源系列、qwen-coder 系列、qwen-doc-turbo、Qwen3-VL(非思考模式):0.7
- QVQ 系列:0.5
- qwen-audio-turbo 系列:0.00001
- qwen-vl 系列:0.01
- qwen-math 系列:0
- Qwen3.7(思考模式)、Qwen3.6(思考模式)、Qwen3.5(思考模式)、Qwen3(思考模式)、Qwen3-Thinking、QwQ 系列:0.6
- qwen-long 系列:1.0
- qwen-plus-character:0.92
- Qwen3-VL(思考模式):0.8
第三方模型默认 temperature 值:
- DeepSeek 系列(阿里云直供):deepseek-v4.1-flash、deepseek-v4.1-flash-1017、deepseek-v4-pro-0813、deepseek-v4-pro、deepseek-v4-flash-0731: 1.0
- DeepSeek 系列(硅基流动直供):siliconflow/deepseek-v3.2、siliconflow/deepseek-v3.1-terminus、siliconflow/deepseek-r1-0528、siliconflow/deepseek-v3-0324: 1.0
- DeepSeek 系列(快手万擎直供):vanchin/deepseek-v3.2-think(思考模式): 0.6;vanchin/deepseek-v3.1-terminus: 0.7;vanchin/deepseek-v3.2-speciale、vanchin/deepseek-r1、vanchin/deepseek-v3、vanchin/deepseek-ocr: 1.0
- Kimi 系列(阿里云直供):kimi-k2.7-code、kimi-k2.6(思考模式)、kimi-k2.5(思考模式): 1.0;kimi-k2.6(非思考模式)、kimi-k2.5(非思考模式): 0.6
- Kimi 系列(月之暗面直供):kimi/kimi-k3、kimi/kimi-k3.1-pro、kimi/kimi-k3.1-pro-highspeed、kimi/kimi-k2.7-code-highspeed、kimi/kimi-k2.7-code、kimi/kimi-k2.6(思考模式)、kimi/kimi-k2.5(思考模式): 1.0;kimi/kimi-k2.6(非思考模式)、kimi/kimi-k2.5(非思考模式): 0.6
- GLM 系列(阿里云直供):glm-5.1、glm-5: 1.0
- GLM 系列(智谱直供):ZHIPU/GLM-5.1、ZHIPU/GLM-5: 0.6
- MiniMax 系列(阿里云直供):MiniMax-M2.5: 1.0
- MiniMax 系列(稀宇科技直供):MiniMax/MiniMax-M3、MiniMax/MiniMax-M2.7、MiniMax/MiniMax-M2.5、MiniMax/MiniMax-M2.1: 1.0
- MiMo 系列(小米直供):mimo-v2.5-pro: 1.0,范围 [0, 1.5];xiaomi/mimo-v2.6-pro-ultraspeed: 1.0,不支持自定义,传入其他值时仍按 1.0 生效。
qwen4-max:思考模式默认 0.95,非思考模式默认 0.8。
核采样阈值。较高的值使输出更多样化。取值范围:(0, 1.0]。
各模型默认值:
- Qwen3.7(思考模式)、Qwen3.6(非思考模式)、Qwen3.5(非思考模式)、Qwen3(非思考模式)、Qwen3-Instruct 系列、Qwen3-Coder 系列、qwen-max 系列、qwen-plus 系列(非思考模式)、qwen-flash 系列(非思考模式)、qwen 开源系列、qwen-coder 系列、qwen-long、qwq-32b-preview、qwen-doc-turbo、Qwen3-VL(非思考模式):0.8
- qwen2.5-vl-3b/7b/32b/72b-instruct:0.001
- QVQ 系列:0.5
- qwen-math 系列:1.0
- Qwen3.7(思考模式)、Qwen3.6(思考模式)、Qwen3.5(思考模式)、Qwen3(思考模式)、Qwen3-VL(思考模式)、Qwen3-Thinking、QwQ 系列、qwen-plus-character:0.95
- DeepSeek 系列(阿里云直供):deepseek-v4.1-flash、deepseek-v4.1-flash-1017、deepseek-v4-pro-0813、deepseek-v4-pro、deepseek-v4-flash-0731: 0.95
- DeepSeek 系列(硅基流动直供):siliconflow/deepseek-v3.2、siliconflow/deepseek-v3.1-terminus、siliconflow/deepseek-r1-0528、siliconflow/deepseek-v3-0324: 1.0
- DeepSeek 系列(快手万擎直供):vanchin/deepseek-v3.2-think、vanchin/deepseek-v3.1-terminus: 0.95;vanchin/deepseep-v3.2-speciale: 0.9;vanchin/deepseek-r1: 0.8;vanchin/deepseek-v3、vanchin/deepseek-ocr: 1.0
- Kimi 系列(阿里云直供):kimi-k2.7-code、kimi-k2.6、kimi-k2.5: 0.95
- Kimi 系列(月之暗面直供):kimi/kimi-k3、kimi/kimi-k3.1-pro、kimi/kimi-k3.1-pro-highspeed、kimi/kimi-k2.7-code-highspeed、kimi/kimi-k2.7-code、kimi/kimi-k2.6、kimi/kimi-k2.5: 0.95
- GLM 系列(阿里云直供):0.95
- GLM 系列(智谱直供):ZHIPU/GLM-5.1、ZHIPU/GLM-5: 0.95
- MiniMax 系列(阿里云直供):MiniMax-M2.5: 0.95
- MiniMax 系列(稀宇科技直供):MiniMax/MiniMax-M2.7、MiniMax/MiniMax-M2.5、MiniMax/MiniMax-M2.1: 0.9
- MiMo 系列(小米直供):xiaomi/mimo-v2.5-pro: 0.95,范围 [0.01, 1.0];xiaomi/mimo-v2.6-pro-ultraspeed: 0.95,不支持自定义,传入其他值时仍按 0.95 生效。
QVQ 模型请勿修改默认 top_p 值。
qwen4-max:默认 20。
采样候选 token 集合的大小。较大的值增加随机性,较小的值增加确定性。如果为 None 或大于 100,则 top_k 不生效,仅 top_p 起作用。必须 >= 0。
各模型默认值:
- QVQ 系列:10
- QwQ 系列:40
- Qwen3-Omni-Flash 系列:50
- GLM 系列(阿里云直供):20
- DeepSeek/Kimi/MiniMax 系列均不支持 top_k 参数
- 所有其他模型:20
QVQ 模型请勿修改默认 top_k 值。
qwen4-max:限制思考与最终回答的 Token 总数。思考模式最大 262144,非思考模式最大 131072;未传入时使用当前模式的最大值。
(即将废弃,新接入请使用 max_completion_tokens)生成的最大 token 数。达到限制时,生成停止且 finish_reason 为 length。不限制思考链长度。GLM 模型的默认值与最大值如下,其他模型的默认值与最大值均为模型的最大输出长度。
- 阿里云直供(glm-5.3、glm-5.2、glm-5.2-fast-preview、glm-5.1、glm-5):默认值 65536,最大值 131072
- 智谱直供(ZHIPU/GLM-5.3、ZHIPU/GLM-5.3-Flash、ZHIPU/GLM-5.3-FlashX、ZHIPU/GLM-5.2、ZHIPU/GLM-5.1、ZHIPU/GLM-5):默认值 65536,最大值 131072
注意: 对于 GLM-5.2 及之后的 GLM 系列模型,max_tokens 的行为与 max_completion_tokens 一致——它限制包含思维链在内的总输出长度,而非仅限制最终回复。建议对 GLM-5.2 系列模型直接使用 max_completion_tokens 以获得更明确的语义控制。
qwen4-max:限制思考与最终回答的 Token 总数。思考模式最大 262144,非思考模式最大 131072;未传入时使用当前模式的最大值。
限制模型本次响应中输出的最大 Token 数,包含思维链。达到限制时,生成停止且 finish_reason 为 length。GLM 模型的默认值与最大值见 max_tokens 参数中的说明,其他模型的默认值与最大值均为模型的最大输出长度。
与 max_tokens 的区别:max_completion_tokens 始终限制模型完整输出(思维链 + 回答);max_tokens 的具体限制范围随模型及 thinking_budget 设置而异,见上文说明。思考类模型推荐使用 max_completion_tokens。
支持以下模型:
- 千问 Max:Qwen3.7-Max 及之后的模型
- 千问 Plus:Qwen3.5-Plus 及之后的模型
- 千问 Flash:Qwen3.5-Flash 及之后的模型
- Kimi:kimi-k2.5 及之后的模型
- GLM:
max_tokens参数中列出的阿里云直供和智谱直供模型 - MiniMax:MiniMax-M2.5 及之后的模型
- DeepSeek:deepseek-v4-pro-0813、deepseek-v4-pro、deepseek-v4.1-flash 及之后的模型
除 max_tokens 参数中列出的智谱直供 GLM 模型外,以上模型均不包含其他三方直供模型。实际输出 Token 数与设置值之间最多可能存在 10 个 Token 的误差。
Java SDK 暂不支持该参数。通过 HTTP 调用时,请将 max_completion_tokens 放入 parameters 对象中。
是否流式输出响应。HTTP 流式输出还需设置 X-DashScope-SSE: enable 请求头。Java SDK 流式输出请使用 streamCall 接口。
流式输出时,是否仅返回新增的增量 token(true)还是返回到目前为止的完整累积文本(false)。
qwen4-max:默认 true。
是否启用思考模式。适用于混合思考模型:Qwen3.7、Qwen3.6、Qwen3.5、Qwen3、Qwen3-VL 系列,以及 DeepSeek-V4-Pro/V4-Flash 系列(阿里云直供)、Kimi-K2.6/K2.5 系列(阿里云直供)、GLM 系列。qwen3.8-max 默认开启思考模式。DeepSeek-V4 系列默认开启思考,可通过 reasoning_effort 参数调整推理力度。启用后,思考内容通过 reasoning_content 字段返回。Java SDK 为 enableThinking;通过 HTTP 调用时,请将 enable_thinking 放入 parameters 对象中。
qwen4-max:默认 true。历史 reasoning_content 需完整回传;摘要模式回传 encrypted_content。
是否将对话历史中 assistant 消息的 reasoning_content 拼接至模型输入。适用于需要模型参考历史思考过程的场景。
kimi/kimi-k3.1-pro 和 kimi/kimi-k3.1-pro-highspeed 支持此参数,默认关闭。
目前支持 qwen3.8-max(默认开启)、qwen3.8-max-0902(默认开启)、qwen3.7-max、qwen3.7-max-2026-05-20以及后续快照、qwen3.7-plus、qwen3.7-plus-2026-05-26、qwen3.6-plus、qwen3.6-plus-2026-04-02、qwen3.8-flash、qwen3.7-flash、qwen3.7-flash-2026-07-15、qwen3.6-flash、qwen3.6-flash-2026-04-16、kimi-k2.6(千问AI平台部署)、kimi-k2.7-code(千问AI平台部署,默认开启)、kimi/kimi-k2.7-code-highspeed(月之暗面直供,默认开启)、kimi/kimi-k2.7-code(月之暗面直供,默认开启)。
- 若历史消息中不包含 reasoning_content,开启此参数不会报错,正常兼容。
- 开启后,历史对话中的 reasoning_content 会计入输入 Token 数量并计费。
通过 HTTP 调用时,请将 preserve_thinking 放入 parameters 对象中。暂不支持 Java SDK。
重要: 使用 qwen3.8-max 时,preserve_thinking 默认为 true,必须将历史对话中所有的 reasoning_content 完整回传。不支持将 reasoning_content 拼接到 content 字段中回传。
qwen4-max:默认 131072,上限 262144。仅设置预算时的档位映射见 reasoning_effort。不支持同时设置 reasoning_effort 和 thinking_budget;thinking_budget 必须为正整数,不能设为 0。其他型号的默认值按下述规则。
思考链的最大长度。适用于 Qwen3.7、Qwen3.6、Qwen3.5、Qwen3-VL、Qwen3、GLM(阿里云直供)和 Kimi(阿里云直供)系列模型,其中 kimi-k3 和 kimi-k3.1-pro 不支持该参数。默认为模型的最大思维链长度。Java SDK 为 thinkingBudget。通过 HTTP 调用时,请将 thinking_budget 放入 parameters 对象中。
qwen4-max:默认 high。minimal/low → low;medium/high → high;xhigh/max → xhigh;none 关闭思考。仅设置档位时预算保持 131072;仅设置 thinking_budget 时,1–4096 → low,4097–131072 → high,131073–262144 → xhigh,保留原预算。均未设置时为 high 和 131072。
控制模型的推理力度。
kimi-k3.1-pro(千问AI平台部署):默认值为 max。可选值:max(深度推理)、high(增强推理)、medium(中度推理)、low(轻度推理)。enable_thinking 默认为 true,支持设为 false 关闭思考,但建议保持开启,关闭会显著影响模型输出效果。
Qwen3.8 系列: 可选值:low、medium、xhigh。默认 xhigh。不支持与 thinking_budget 同时设置,同时设置会报错。两者支持互转:未设置 thinking_budget 时,reasoning_effort 自动映射 thinking_budget(low→4096,medium→16384,xhigh→262144);未设置 reasoning_effort 时,thinking_budget 自动映射回 reasoning_effort(0-4096→low,4097-16384→medium,16385-262144→xhigh);两者均未设置时,使用默认 thinking_budget(131072),默认 reasoning_effort(xhigh)。
DeepSeek-V4 与 GLM 系列: 可选值:high(高力度推理)、max(最大力度推理)。low 和 medium 映射为 high,xhigh 映射为 max。适用于 glm-5.2、glm-5.1、glm-5、deepseek-v4-pro(阿里云直供)。
kimi/kimi-k3、kimi/kimi-k3.1-pro、kimi/kimi-k3.1-pro-highspeed(月之暗面直供): 默认值为 max,仅支持 max。
glm-5.3、ZHIPU/GLM-5.3、ZHIPU/GLM-5.3-Flash、ZHIPU/GLM-5.3-FlashX、kimi-k3(阿里云直供): 默认值:max。可选值:max(默认,深度推理)、high(增强推理)、low(轻度推理)。该模型始终开启思考,enable_thinking 仅支持 true,传入 false 会导致 API 请求失败。
deepseek-v4-flash-0731、deepseek-v4-pro-0813、deepseek-v4.1-flash、deepseek-v4.1-flash-1017: 默认值:high。可选值:max(最大力度推理)、high(默认,高力度推理)、low(低力度推理)。出于兼容性考虑,medium 映射为 high,xhigh 映射为 high。
通过 HTTP 调用时,请将 reasoning_effort 放入 parameters 对象中。
用于控制多轮对话中是否将历史轮次的 reasoning_content(思考过程)作为上下文输入给模型。仅 GLM 系列(glm-5.3、glm-5.2、glm-5.1、glm-5)模型支持。其中 glm-5.3 的默认值为 true,其余模型的默认值为 false。
true:开启。忽略历史轮次的 reasoning_content,仅使用可见文本、工具调用与结果等非推理内容作为上下文输入,可降低上下文长度与成本。false(默认):不开启。保留历史轮次的 reasoning_content 并随上下文一同提供给模型。若希望启用 Preserved Thinking,必须在 messages 中完整、未修改、按原顺序透传历史 reasoning_content,缺失、裁剪、改写或重排会导致效果下降或无法生效。
通过 HTTP 调用时,请将 clear_thinking 放入 parameters 对象中。
仅影响复杂工具参数的流式输出行为,仅在流式调用时生效。普通工具参数(所有参数类型均为 string)只要开启流式调用即可流式输出,tool_stream 对其无影响。复杂工具是指工具定义中某些参数类型为 array 或 object。当前仅 Qwen 和 GLM 系列支持。
Qwen 系列支持列表:
- qwen-max 系列:qwen3.8-max 系列、qwen3.7-max 系列的文本模态
- qwen-plus 系列:qwen3.7-plus 系列、qwen3.6-plus 系列的文本模态,以及 qwen3.5-plus 系列的全模态
- qwen-flash 系列:qwen3.8-flash 系列、qwen3.7-flash 系列、qwen3.6-flash 系列、qwen3.5-flash 的全模态
Qwen 系列使用参考:
tool_stream=false:复杂工具参数会一次性输出,默认行为,复杂格式会更准确。tool_stream=true:复杂工具参数会流式输出,复杂格式没有超时风险。
GLM 系列支持列表: glm-5、glm-5.1(阿里云直供)。
GLM 系列使用参考:
tool_stream=false:工具参数会一次性输出,默认行为,复杂格式会更准确。tool_stream=true:工具参数会流式输出,复杂格式没有超时风险。
通过 HTTP 调用时,请将 tool_stream 放入 parameters 对象中。
是否启用代码解释器功能。
qwen4-max:默认 1.0。
token 重复惩罚系数。1.0 表示不惩罚,较高的值减少重复。必须为正数。
第三方模型默认值:
- GLM 系列(阿里云直供):1.0
QVQ 模型请勿修改默认 repetition_penalty 值。
qwen4-max:思考模式默认 0.0,非思考模式默认 1.5。
控制模型避免重复文本中已有内容的程度。取值范围:[-2.0, 2.0]。正值减少重复,负值增加重复。
各模型默认值:
- Qwen3.6(非思考模式)、Qwen3.5(非思考模式)、Qwen3(非思考模式)、Qwen3-Instruct 系列、qwen3-0.6b/1.7b/4b(思考模式)、QVQ 系列、qwen-max、qwen-max-latest、qwen2.5-vl 系列、Qwen3-VL(非思考模式):1.5
- qwen-plus/qwen-plus-latest/2025-04-28(思考模式):0.5
- 所有其他模型:0.0
QVQ 模型请勿修改默认值。
qwen4-max:默认 1234,范围 [0, 2^31-1]。
随机种子,用于结果复现。取值范围:[0, 2³¹−1]。使用相同的种子和参数时,模型会尽可能返回相同的结果。
停止序列。当生成的文本包含指定的字符串或 token ID 时,生成立即停止。同一数组中不要混用字符串和 token ID。并非所有模型都支持,请查看模型文档。
定义工具选择策略。思考模式的模型不支持强制指定工具。
是否启用并行工具调用。思考模式的模型在强制指定工具时不支持此功能。kimi/kimi-k3.1-pro 和 kimi/kimi-k3.1-pro-highspeed 不支持此参数。详见并行工具调用。
返回内容的格式。设为 json_object 时,必须在提示词中指示模型输出 JSON。
显示子属性
显示子属性
输出格式类型。text:纯文本。json_object:标准 JSON 字符串。json_schema:符合指定 schema 的 JSON。
qwen4-max 支持此参数。
是否返回输出 token 的对数概率。支持的模型:qwen-plus 系列的快照模型、qwen3-vl-plus 系列、Qwen3 开源模型。具体支持的模型请查看模型页面。
每个生成步骤返回的最可能候选 token 数。有效值:0–5。仅在 logprobs 为 true 时生效。支持的模型与 logprobs 相同。
qwen4-max 支持此参数。
生成的响应数量。范围:1–4。支持 qwen4-max 和非思考模式的 Qwen3 模型。指定 tools 时固定为 1。会增加输出 token 消耗。kimi/kimi-k3.1-pro 和 kimi/kimi-k3.1-pro-highspeed 不支持此参数。
对 qwen4-max,即使 vl_high_resolution_images=true,显式传入的 max_pixels 仍生效。
以下固定分辨率及 max_pixels 规则适用于下方列出的模型。
是否启用高分辨率图像处理。启用后使用固定分辨率策略,max_pixels 被忽略。默认值:false。
启用时(true)的像素限制:
- Qwen3.5 系列、Qwen3-VL 系列:固定为 16777216 像素(16384 个 token × 32×32 像素)
- QVQ 系列和其他 Qwen2.5-VL 系列:固定为 12845056 像素(16384 个 token × 28×28 像素)
为 false 时,像素限制由 max_pixels 决定。
是否在响应中返回缩放后图像的尺寸(image_hw 字段)。流式输出时在最后一个数据块中返回。适用于 Qwen-VL 系列模型。
模型在生成文本时是否使用互联网搜索结果进行参考。取值:true 启用互联网搜索,模型会将搜索结果作为文本生成过程中的参考信息,但模型会基于其内部逻辑判断是否使用互联网搜索结果;false 关闭互联网搜索。若开启后未联网搜索,可优化提示词,或设置 search_options 中的 forced_search 参数开启强制搜索。启用互联网搜索功能可能会增加 Token 的消耗。Java SDK 为 enableSearch;通过 HTTP 调用时,请将 enable_search 放入 parameters 对象中。详情参见联网搜索。
联网搜索的策略。仅当 enable_search 为 true 时生效。通过 HTTP 调用时,请将 search_options 放入 parameters 对象中。Java SDK 为 searchOptions。详情参见联网搜索。
显示子属性
显示子属性
在返回结果中是否展示搜索到的信息。true 展示;false 不展示。
是否开启 [1] 或 [ref_1] 样式的角标标注功能。在 enable_source 为 true 时生效。true 开启;false 不开启。
角标样式。在 enable_citation 为 true 时生效。[<number>] 角标形式为 [1];[ref_<number>] 角标形式为 [ref_1]。
是否强制开启搜索。true 强制开启;false 不强制开启。
搜索互联网信息的策略。turbo(默认)兼顾响应速度与搜索效果,适用于大多数场景;max 采用更全面的搜索策略,可调用多源搜索引擎,以获取更详尽的搜索结果,但响应时间可能更长;agent 可多次调用联网搜索工具与大模型,实现多轮信息检索与内容整合,该策略仅适用于 qwen3.7-max、qwen3.7-max-2026-05-20、qwen3.5-plus、qwen3.5-plus-2026-02-15、qwen3.5-flash、qwen3.5-flash-2026-02-23,启用时仅支持返回搜索来源(enable_source: true),其他联网搜索功能不可用。
是否开启特定领域增强。true 开启;false 不开启。
在流式输出且 enable_source 为 true 时,配置第一个返回的数据包是否只包含搜索来源信息。true 只包含搜索来源信息;false 包含搜索来源信息与大模型回复信息。暂不支持 DashScope Java SDK。
技能参数,用于启用特定生成技能(如 PPT 生成)。仅 qwen-doc-turbo 模型支持。详细用法请参见生成 PPT。
使用 skill 时,stream 必须设置为 true。
通过 HTTP 调用时,请将 skill 放入 parameters 对象中。
显示子属性
显示子属性
技能类型。当前支持:
ppt:PPT 生成。
PPT 生成模式。可选值:
general(默认值):模板模式,需配合template_id使用,生成 HTML 格式的 PPT。creative:创意模式,无需模板,生成图版 PPT(每页为图片)。
PPT 模板 ID。mode 为 general 或未设置 mode 时使用。可选值:
news_01:新闻模板summary_01:总结模板internet_01:互联网模板thesis_01:论文模板
仅 qwen4-max,开启思维链摘要与加密。 CoT summary.
仅 qwen4-max。按 Token 已出现的次数施加惩罚,以调整重复内容生成。
响应
请求的状态码。200 表示成功。Java SDK 不返回此字段;调用失败时会抛出包含 status_code 的异常。
此请求的唯一标识符。在 Java SDK 中为 requestId。
错误码。请求成功时为空字符串。仅 Python SDK 返回此字段。
可读的错误信息。请求成功时为空字符串。
模型的输出。
显示子属性
显示子属性
生成的文本。当 result_format 为 text 时返回。
生成停止的原因。当 result_format 为 text 时返回。取值:null(仍在生成中)、stop(自然结束或触发停止条件)、length(达到最大 token 数)、tool_calls(触发工具调用)。
输出选项。当 result_format 为 message 时返回。
显示子属性
显示子属性
生成停止的原因。取值:null(生成中)、stop、length、tool_calls。
助手的输出消息。
显示子属性
显示子属性
固定为 assistant。
消息内容。文本模型为字符串;Qwen-VL/Qwen-Audio 模型为数组。存在 tool_calls 时为空。
深度思考内容。启用思考模式时返回。
qwen4-max 开启摘要后返回完整思维链密文。每轮开启摘要并原样回传所属消息的密文;不可截断、重新编码、修改或拼接多轮密文。摘要不能替代历史思维链。未产生思考或加密失败时可能缺失。 CoT summary.
此请求的 token 用量信息。
显示子属性
显示子属性
用户输入的 token 数。
模型输出的 token 数。
总 token 数(输入 + 输出)。纯文本输入时返回。
输入图像的 token 数。输入包含图像时返回。
输入视频的 token 数。输入包含视频时返回。
输入音频的 token 数。输入包含音频时返回。