如何在阿里云百炼平台申请并获取Qwen-Max的API Key？

Question

常见问题：在阿里云百炼平台申请Qwen-Max的API Key时，页面未显示Qwen-Max模型选项，或调用返回“Model not found”错误，是什么原因？ 答：Qwen-Max为阿里云定向开放的高性能闭源模型，**不默认对所有用户开放**。需先完成实名认证+企业认证（个人开发者暂不可用），并在百炼控制台「模型管理」中提交《Qwen-Max试用申请》，填写业务场景、预期调用量及合规承诺；审核通常1–3个工作日。通过后，模型才会出现在API调用下拉列表中，且API Key需在「API密钥管理」中单独创建（勾选“百炼”服务权限）。注意：该Key仅限百炼SDK/HTTP接口调用，不可用于DashScope通用API；若仍不可见，请确认账号所属主账号已开通百炼服务并完成欠费结清。

Answer 1

```html

一、现象层：典型错误表现与前端可见性问题

• 在百炼控制台「模型管理」→「API调用配置」页面，下拉列表中完全不显示 qwen-max 选项；
• 使用已创建的API Key调用 https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation 接口时，返回 {"code":"ModelNotFound","message":"Model not found"}；
• 即使在「API密钥管理」中勾选了“DashScope”服务权限，仍无法调用成功——说明权限绑定逻辑存在服务域隔离。

二、权限层：准入机制的三重门控体系

Qwen-Max并非标准SaaS模型，其访问受阿里云百炼平台严格的RBAC+ABAC混合策略管控：

门控层级	强制条件	验证位置
身份认证门	完成实名认证 + 企业实名认证（营业执照/统一社会信用代码）	阿里云账号中心 → 认证管理
服务开通门	主账号已开通「百炼」服务且无欠费（含试用期超限冻结）	费用中心 → 账单管理 + 百炼控制台首页状态栏
模型授权门	通过《Qwen-Max试用申请》人工审核（非自动开通）	百炼控制台 → 模型管理 → 试用申请入口

三、流程层：端到端开通路径与关键断点

以下为经实测验证的完整链路（含易忽略断点）：

flowchart TD A[完成企业实名认证] --> B[开通百炼服务] B --> C{主账号是否欠费？} C -->|是| D[结清账单并等待系统同步≥15min] C -->|否| E[提交Qwen-Max试用申请] E --> F[填写真实业务场景/日均调用量/数据合规承诺书] F --> G[等待1-3工作日人工审核] G --> H[审核通过后：模型自动出现在模型管理列表] H --> I[进入API密钥管理 → 新建Key → 必须勾选“百炼”服务权限] I --> J[调用时Endpoint必须为百炼专属地址：
https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation]

四、技术层：API调用的协议级约束

• Endpoint隔离：Qwen-Max仅支持百炼SDK或百炼HTTP接口，不兼容DashScope通用API的/v1/models枚举能力；
• Header强校验：请求头必须包含 X-DashScope-Source: bailing，否则触发403；
• 模型名称大小写敏感：合法值为 "model": "qwen-max"（全小写），Qwen-Max 或 qwen_max 均返回ModelNotFound；
• 鉴权Key绑定服务域：同一API Key若同时勾选“DashScope”和“百炼”，Qwen-Max调用仍会失败——必须新建仅勾选“百炼”的专用Key。

五、排障层：高阶诊断清单（面向5年+工程师）

1. 执行 curl -X GET "https://dashscope.aliyuncs.com/api/v1/models?api_key=YOUR_KEY" -H "Content-Type: application/json" 验证Key基础可用性；
2. 检查响应中 "models" 数组是否包含 {"model":"qwen-max", "status":"available"} —— 若无，则未通过审核或未生效；
3. 使用 aliyun openapi describe-resources --service-name bailing CLI命令确认百炼服务资源状态；
4. 抓包分析请求Header，确认是否存在 X-DashScope-Source 及其值是否为 bailing；
5. 查看百炼控制台右上角「消息中心」是否有审核驳回通知（常被忽略）；
6. 登录阿里云工单系统，搜索关键词“Qwen-Max 审核进度”，获取人工审核流水号及当前状态。

```