Qwen4-Max 入门:调通 API、看图思考与显式缓存

用百炼免费额度调通 qwen4-max,看图思考并开启显式缓存

入门3 课时65 分钟图文实操

免费学习无需登录

Qwen4-Max 入门:调通 API、看图思考与显式缓存 课程封面

你将学会

  • 在北京地域开通百炼,配好 API Key 和业务空间 ID
  • 用 curl 和 Python 调通 qwen4-max
  • 看懂默认深度思考、reasoning_effort 和按量计费
  • 用假 Key 复现 401 invalid_api_key
  • 打开思维链摘要与加密,并在多轮中回传密文
  • 把官方示例图传给模型完成看图问答
  • 用 Qwen4 显式缓存断点复用长前缀
  • 对照 cached_tokens 与 cache_write_tokens,并估算 5m 缓存费用

适合谁

  • 想立刻调用新旗舰 qwen4-max 的开发者
  • 已经学过《千问 API 入门》,要补上摘要、看图和 Qwen4 显式缓存的人
  • 需要先在免费额度里跑通,再决定是否按量加钱的团队

课前准备

  • 会用终端
  • 本机有 Python 3.9+ 和 curl
  • 已实名认证的阿里云账号

课程目录

3 课时 · 65 分钟
  1. 01开通百炼,用 curl 和 Python 调通 qwen4-max认清 qwen4-max 与预览版的差别,在华北 2(北京)拿到 API Key 和业务空间 ID,用业务空间专属域名以 curl 和 Python 发出第一个请求,看懂默认思考、免费额度和计费,并用假 Key 复现 401。图文22 分钟开始本课
  2. 02思维链摘要与加密,再让模型读一张官方示例图用流式输出分开打印思考和回答,用 reasoning_effort 选择强度;打开 thinking_display=summarized,在「17×23」和「再加 9」两轮中回传密文;再把官方示例图传给 qwen4-max,对照官方看图描述。图文22 分钟开始本课
  3. 03用 Qwen4 显式缓存复用长前缀,对照创建与命中计费分清隐式缓存、手动断点和自动缓存;用 prompt_cache_breakpoint 连续请求两次并读懂 usage;按北京官方单价估算 5m 缓存费用,再按需设置 TTL 或打开自动缓存。图文21 分钟开始本课

课程说明

Qwen4-Max 是通义千问在 2026 年 11 月 16 日发布的新一代旗舰多模态模型,模型调用 ID 为 qwen4-max。它把文本生成、图片与视频理解和深度思考放在同一个模型里,支持工具调用、结构化输出、联网搜索,以及 Qwen4 才有的思维链摘要与加密、显式缓存(自动缓存和 5 分钟 / 1 小时 TTL)。接口兼容 OpenAI Chat Completions、Responses、Anthropic Messages 和 DashScope。

本课走阿里云百炼华北 2(北京)的按量调用,用业务空间专属域名。北京地域为该模型提供 100 万 Token 新人免费额度(90 天),建议同时打开「用完即停」。

本课按阿里云百炼官方文档整理,对照页包括模型页、文本生成、深度思考、思维链摘要与加密、图像与视频理解、显式缓存(Qwen4)、获取 API Key、地域与接入域名、新人免费额度和模型价格。全部链接见课程介绍末尾。站内已有《千问 API 入门》讲的是 2026 年 10 月的 qwen3.8-max,以及 JSON Schema、工具调用、Claude Code / Qwen Code 接入;本课不重复那些步骤,只跟做 Qwen4-Max 的新能力。

测试说明:2026-11-18 在 Debian 云主机上核验了官方文档、示例图片和命令能否原样复制;用假 API Key 实打了 401 invalid_api_key。本机没有可用的百炼 API Key,因此成功调用的对照结果一律采用官方文档给出的示例(思考流式输出、「你是谁?」回复、官方示例图描述、缓存 usage 字段)。你用自己的免费额度跑通后,具体文字、Token 数和时间都会不同,字段结构应与官方一致。没有实测的部分会在正文写明,包括:控制台开通的点击路径因账号而异、视频理解、Token Plan / 国际站 QwenCloud 的完整走法。

你会学到

  • 在华北 2(北京)开通百炼、拿到 API Key 和业务空间 ID,用 curl 和 Python 调通 qwen4-max
  • 看懂默认开启的深度思考、reasoning_effort 和按量计费,并用假 Key 复现 401
  • 打开思维链摘要与加密,在多轮对话里原样回传密文
  • 把官方示例图传给模型,完成一次看图问答
  • 给长前缀打上 Qwen4 显式缓存断点,对照创建缓存和命中缓存的 usage 与费用

适合

  • 想立刻调用新旗舰 qwen4-max 的开发者
  • 已经学过《千问 API 入门》,要补上思维链摘要、看图和 Qwen4 显式缓存的人
  • 需要在免费额度里先跑通,再决定要不要按量加钱的团队

先修

  • 会用 Linux、macOS 或 Windows 终端
  • 本机有 Python 3.9 或更高版本,以及 curl
  • 已实名认证的阿里云账号(免费额度只发给完成实名、并在北京地域开通百炼的账号)

官方来源