模型名称必须严格匹配千问API控制台「当前已开通的模型」列表中的精确字符串，大小写、连字符、数字均不可修改，否则导致请求失败或403/400错误。

调用千问AI API时，模型名称填错会导致请求直接失败或返回非预期结果，必须严格匹配官方文档中公布的当前可用模型标识符。

查看当前可用模型列表

打开千问API控制台 → 进入「模型管理」页面 → 点击「API调用」标签页，页面顶部会显示「当前已开通的模型」列表。

注意：控制台中展示的模型名称就是API请求中model字段必须填写的精确字符串，大小写、连字符、数字均不可修改。

在API请求中填写模型名称

方法一：使用curl命令行调用

在JSON体中指定"model": "qwen-max"，例如：

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation

-H "Authorization: Bearer your-api-key"

-H "Content-Type: application/json"

-d '{"model": "qwen-max", "input": {"messages": [{"role": "user", "content": "你好"}]}}'

方法二：在Python SDK中设置

初始化Generation实例时，将model参数设为字符串"qwen-plus"或"qwen-turbo"等有效值：

from dashscope import Generation

response = Generation.call(model="qwen-plus", input={"messages": [{"role": "user", "content": "解释量子纠缠"}]})

【必须确保model值与控制台开通状态一致，未开通的模型名即使语法正确也会返回403错误】

常见错误模型名及修正

第一步：检查是否误用了旧版命名——如填"qwen-7b-chat"（开源模型名）或"qwen-vl"（多模态模型），这些不能用于标准文本生成API。

第二步：确认是否混淆了服务类型——"qwen-audio"仅适用于语音转文字接口，填入文本生成请求会报错400。

第三步：排除拼写空格——"qwen max"（带空格）、"Qwen-Max"（首字母大写）均为非法值，API严格区分大小写且不接受空格。