在新加坡 Model Studio workspace 中,用模型 ID qwen4-max 调用 OpenAI 兼容 Chat Completions;reasoning_effort 可设为 low、high 或 xhigh,默认是 high。
适合的任务:通过 cURL 或 OpenAI 兼容客户端调用阿里云 Model Studio 上的 Qwen4-Max
不适合的任务:需要在同一请求中同时指定推理档位和推理 token 预算的任务
适用的模型版本:官方模型页列出的 qwen4-max(Latest Model)
适用的客户端、Agent 或 API:OpenAI Chat Completions 兼容 API、cURL;其他地区或 API 格式需对应替换区域端点或接入协议
推荐的推理档位和参数:复杂任务用 high(默认);优先延迟或较轻任务可用 low;更高推理强度用 xhigh
示例固定使用新加坡区域和 workspace 专属域名。先在当前终端安全设置环境变量 WORKSPACE_ID 与 DASHSCOPE_API_KEY,不要把密钥写入脚本、代码仓库或请求正文:
: "${WORKSPACE_ID:?请设置 Model Studio 新加坡区域的 Workspace ID}"
: "${DASHSCOPE_API_KEY:?请安全设置 Model Studio API Key}"
curl --fail-with-body \
"https://${WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen4-max",
"messages": [
{"role": "user", "content": "用三点总结什么是缓存。"}
],
"reasoning_effort": "high"
}'| 配置项 | 值 |
|---|---|
| 区域 | Singapore(新加坡) |
| Base URL | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
| Chat Completions 路径 | /chat/completions |
| 模型 ID | qwen4-max |
| 推理档位 | low、high、xhigh;默认 high |
WorkspaceId 可在 Model Studio 控制台的 Workspace Details 中查看。官方文档推荐对新加坡请求使用 workspace 专属域名;旧域名仍可用。API Key 应从对应区域的 Model Studio 控制台获取。
在 Model Studio 控制台选择新加坡区域,确认工作空间并获取 Workspace ID 和 API Key。
在当前 shell 中设置 WORKSPACE_ID 与 DASHSCOPE_API_KEY,运行上面的 cURL 请求。
改用 low 或 xhigh 调整推理强度;不要同时提交 thinking_budget。
模型页将模型列为 qwen4-max (Latest Model),模型调用 ID 为 qwen4-max;并列出 reasoning_effort 的支持档位与默认值。
API 文档的新加坡区域示例给出 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 及 /chat/completions 路径,并说明 Workspace ID 的控制台位置。
API 文档说明 qwen4-max 的 reasoning_effort 默认值为 high,有效档位映射为 low、high、xhigh;reasoning_effort 与 thinking_budget 不能同时设置。
此配置只示范新加坡区域的 OpenAI 兼容 Chat Completions。中国(北京)、中国香港、美国(弗吉尼亚)、德国(法兰克福)、日本(东京)应使用相应区域的 API 域名及工作空间。
本文采用官方当前列出的准确模型 ID qwen4-max,不添加预览版或快照后缀;可用性和配额以所选区域控制台为准。
官方模型页注明模型支持文本、图片、视频输入;此示例只发送文本。模型上下文长度为 1,000,000 tokens,最大输出长度因思考模式而异,示例不显式设置输出上限。
于 2026-11-17 通过 Tabbit 核对模型页和区域端点。模型页显示更新于 2026-11-16。示例中的 ID、区域域名和档位来自官方文档。API 请求未使用真实密钥运行。OpenAI 兼容 Chat API 文档
Qwen4-Max