TellWorldAI 世界档案
问档案English

首页›实践›实践

实践

Qwen4-Max-Preview 怎么用:通过 Token Plan 调用

Qwen4-Max-Preview 目前只能经 Token Plan 调用。说明专属 key、Base URL 和模型 ID 的设置,以及思考与 max_tokens 的注意事项。

这篇适合谁

这篇适合想在 API 或编程工具里试用 Qwen4-Max-Preview 的开发者。读完后,你应该知道它目前通过什么方式调用,需要设置哪些参数,以及思考模式和输出上限会怎样影响结果。

Qwen4-Max-Preview 是什么

Qwen4-Max-Preview 是通义千问系列的下一代旗舰多模态模型。它把文本生成、图像和视频理解、深度推理结合在一起,面向编程、办公、前端设计和复杂的智能体任务[1]。模型 ID 是 qwen4-max-preview[1]。

它可以接收文本、图像和视频输入,用于截图分析、文档理解和视频分析[1]。上下文长度为 1M token。最大输出是 393,216 token,思考和最终回答共用这一额度[1]。工具调用支持 Function Calling、联网搜索和内置工具,结构化输出支持 JSON Object 和 JSON Schema[1]。

先弄清楚:目前只能通过 Token Plan 调用

Qwen4-Max-Preview 目前处于预览阶段,只能通过 Token Plan 访问,不支持按量付费[1]。预览期从 2026 年 11 月 11 日 10:00 持续到 11 月 25 日 24:00(UTC+8)。预览期内模型不会做任何改动,预览结束后模型会下线[1]。所以它适合试验和评估,不适合直接当作长期稳定的生产依赖。

Token Plan 是阿里云 Model Studio 推出的 AI 模型订阅服务,以 Credits 计费,供兼容的 AI 工具交互式使用[2]。它分为个人版(Personal)和团队版(Team),两者各有一份配置指南[2]。

准备:获取专属 API key

先根据自己的情况选择个人版或团队版,按对应指南开通,并获取专属的 API key[1]。快速开始页面提供了「购买套餐」和「获取 API Key」两个控制台入口,地区是 ap-southeast-1[2]。示例中的 Token Plan key 以 sk-sp- 开头,文档里用 sk-sp-xxxx 作占位符[2]。

调用步骤

  1. 设置 Base URL。专属地址是 https://token-plan.ap-southeast-1.maas.aliyuncs.com。不同协议的完整端点,要以 Token Plan 指南为准[1]。
  2. 设置模型 ID 为 qwen4-max-preview[1]。
  3. 按你使用的协议选择接口。模型兼容 OpenAI Chat Completions、Responses 和 Anthropic Messages 三种 API[1]。

如果你用的是编程工具,Token Plan 概览页给出的快速开始是通过命令行配置 Agent。以 Claude Code 为例,命令如下[2]:

curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash
export TOKEN_PLAN_API_KEY="sk-sp-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
bl config agent --agent claude-code --region ap-southeast-1 --api-key $TOKEN_PLAN_API_KEY --model auto

概览页列出的兼容工具包括 Claude Code、Codex、Qwen Code、OpenClaw、OpenCode 和 Trae 等[2]。

思考模式和输出上限

思考默认开启。reasoning_effort 可以调节思考强度,可选值是 low、medium 和 xhigh,默认是 xhigh[1]。reasoning_effort 和 thinking_budget 不要同时设置[1]。

输出上限是最容易踩的坑。在 OpenAI Chat Completions 里,对 qwen4-max-preview 来说,max_tokens 等同于 max_completion_tokens。两者都限制思考和最终回答的合计 token 数。思考会占用同一份额度,如果你只按回答的长度设置上限,输出就可能被截断。其他 Qwen 模型的行为保持不变[1]。

多轮对话时,Chat Completions 默认开启 preserve_thinking。历史的思考内容要放在 assistant 消息的 reasoning_content 字段里返回,不要拼接进 content[1]。

工具调用和多模态

模型支持 Function Calling、联网搜索和内置工具。工具怎么定义、调用流程是什么,可以分别看 Function Calling 的说明;视觉输入见 Image and video understanding;输出格式见 Structured outputs[1]。

需要注意,Token Plan 概览页提到,AI 工具本身只处理文本。图像、视频、语音等能力,要通过扩展接入[2]。

常见问题

  • 报错或无法调用:先确认你用的是 Token Plan 专属的 key 和 Base URL,而不是普通按量付费的配置。模型只通过 Token Plan 提供,不支持按量付费[1]。
  • 回答被截断:检查 max_tokens 是否把思考的 token 也算了进去,适当放宽上限[1]。
  • 预览结束之后:模型会下线。项目里最好把模型 ID 做成可配置的,方便之后切换[1]。

下一步

页面里还链接了视觉输入、函数调用和结构化输出的分项说明。接入的具体客户端配置,可以按你使用的工具去看 Token Plan 对应的指南[1][2]。

来源

  1. 1
  2. 2
    Token Plan overviewAlibaba Cloud Model Studio docs

引用本页: Qwen4-Max-Preview 怎么用:通过 Token Plan 调用. TellWorld, https://www.tellworld.net/zh/practice/practice-qwen4-max-preview-token-plan. 更新于 2026-11-15

相关动态