返回技能市场
通用工具 安全

千问AI-模型选型

@qianwen-ai/qianwen-model-selector

推荐最合适的千问模型和参数。适用场景：在千问模型之间进行选择、比较千问模型定价、了解千问模型能力、查看用量或账单、查看费用历史记录、执行 skill 需要模型选择建议，或用户按名称明确调用此 skill（例如，使用 qianwen-model-selector）。不适用场景：讨论非千问模型（OpenAI、Gemini 等）、与千问无关的一般 AI 问题。

千问AI平台 热度 529v0.0.2

Qwen 模型选择器（顾问）

检测密钥类型

运行此命令检测 API 密钥类型（输出为 token-plan、payg 或 not-set）：

python3 -c "
import os
from pathlib import Path
env_file = Path('.env')
if not env_file.exists():
    for parent in [Path.cwd()] + list(Path.cwd().parents):
        if (parent / '.git').exists() or (parent / 'skills').is_dir():
            env_file = parent / '.env'
            break
if env_file.exists():
    for line in env_file.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith('#') or '=' not in line:
            continue
        k, v = line.split('=', 1)
        k, v = k.strip(), v.strip().strip('\"').strip(\"'\")
        if k in ('QIANWEN_API_KEY', 'DASHSCOPE_API_KEY') and k not in os.environ:
            os.environ[k] = v
key = os.environ.get('QIANWEN_API_KEY') or os.environ.get('DASHSCOPE_API_KEY') or ''
print('token-plan' if key.startswith('sk-sp-') else 'payg' if key else 'not-set')
"

| 输出 | 计费模式 | 操作 | |--------|-------------|--------| | token-plan | Token Plan（额度） | 只能从[Token Plan 列表](references/recommendation-matrix.md#token-plan-models)中选择。版本未知时，默认采用团队版超集。 | | payg | 按量付费 | 可使用完整模型目录；继续阅读下文。 | | not-set | 未配置密钥 | 不得阻断流程。 询问用户：“您计划使用哪种方式？（1）标准 PAYG 密钥（2）Token Plan 密钥（3）暂时跳过——仅浏览推荐内容。”根据用户的选择继续。 |

Windows：如果 python3 不可用，请使用 python。多行 -c 字符串同时适用于
PowerShell 和 CMD。或者，将该代码片段保存到临时 .py 文件中并运行。

此 skill 以两种模式运行：

  1. 交互式咨询 — 通过提出诊断性问题来推荐合适的模型（参见诊断流程）。
  2. 跨 skill 解析 — 为执行类 skills 提供快速模型查找，供其做出模型

    3. 决策而无需用户交互（参见 [recommendation-matrix.md](references/recommendation-matrix.md)）。

不得编造模型名称——只能推荐此 skill 中列出的模型或 CLI 返回的模型。 此 skill 是 QianWen-AI/qianwen-ai 的一部分。

Skill 目录

按需加载。除非用户明确要求最新数据，否则不要访问外部 URL。

| 位置 | 用途 | |-------------------------------------------|----------------------------------------------------------------------------------| | references/cli-usage.md | CLI 优先的数据策略：何时使用 CLI、3 步登录流程、显示规则 | | references/error-handling.md | CLI 错误分类和恢复操作（身份验证、未找到、网络等） | | references/recommendation-matrix.md | 完整的模型推荐表、跨 Skill 解析、Token Plan、思考模式 | | references/pricing-disclaimer.md | 仅限 PAYG：定价免责声明（CN/EN）及控制台链接 | | references/pricing.md | 仅限 PAYG：定价结构概览（离线快照） | | references/model-list.md | 仅限 PAYG：模型目录（离线快照） | | references/sources.md | 官方文档 URL（仅供手动查阅） |

前提条件

强烈建议使用千问AI平台 CLI——它是获取模型 可用性、定价和配额信息的权威实时数据源。请使用以下命令验证：

qianwen version

如果尚未安装：

npm install -g @qianwenai/qianwen-cli

Node.js 版本必须不低于 18。如果没有 CLI，你仍可根据离线 快照回答一般导航问题，但无法回答有关“最新信息”“确切价格”或“特定模型详情”的问题。

安全与凭证模型

千问AI平台有两套相互独立的凭证系统——不得混淆二者：

| 凭证 | 用途 | 提供方式 | |------------|---------|----------------| | API 密钥（sk-... / sk-sp-...） | 在代码中调用模型 APIs | 环境变量 $DASHSCOPE_API_KEY / $QIANWEN_API_KEY | | CLI 会话 | 为 qianwen CLI 子命令提供授权 | qianwen auth login（浏览器设备授权流程） |

红线（两者均适用）：

  • 禁止以明文形式输出任何凭据值。 使用变量引用；仅报告状态

    • （“已设置” / “未设置”，“有效” / “无效”）。不得显示 .env 或配置文件内容。

  • 禁止混淆这两个系统。 当 CLI 返回 Not authenticated / AUTH_REQUIRED 时，执行

    • 3 步设备流登录（请参阅 [cli-usage.md](references/cli-usage.md#authentication-3-step-login-flow)）。 不得向用户索要 API 密钥，也不得尝试设置 $DASHSCOPE_API_KEY 来修复 CLI 身份验证。

数据获取顺序

根据用户的问题匹配正确的数据源。不得回退到较低层级，除非先尝试更高层级的 恢复操作。

| 问题类型 | 主要来源 | 备注 | |----------------------------------------------------------------|---------------------------------------------------------|------------------------------------------------------| | 常规导航（“文本聊天应选择哪个模型系列？”） | SKILL.md 中的 Default 表 + recommendation-matrix.md | 可离线回答 | | 最新 / 精确 / 具体（价格、模型详情、配额） | 必须使用 CLI — 请参阅 cli-usage.md | 快照数据已过时；禁止编造数值 | | 按能力搜索（“能完成 X 的模型”） | qianwen models search "<X>" --format json | 快照中的关键词覆盖不完整 | | CLI 返回了错误 | 执行 error-handling.md 中的恢复操作，然后重试 | 身份验证失败 → 执行 3 步登录流程，不得跳过登录直接转用快照 | | CLI 完全不可用，且用户拒绝安装/登录 | model-list.md、pricing.md（附数据过时提示） | 仅在 CLI 恢复操作确实失败后 | | 上述所有方式均无法回答，且用户确认进行在线查询 | sources.md 中的 URL | 不得主动获取 |

诊断流程（交互式咨询）

前提条件：继续操作前，请完成上文的 [检测密钥类型](#detecting-key-type) 并缩小候选范围。
以下所有推荐都必须在用户的计费范围内。

按顺序询问用户：

  1. 内容类型？ — 文本 / 图像 / 视频 / 音频 / 视觉
  2. 主要任务？ — 生成 / 理解 / 编程 / 推理 / 翻译
  3. 优先级？ — 质量、速度还是成本
  4. 输入大小？ — 短上下文 / 中等上下文 / 长上下文
  5. 结构化输出？ — 是否需要 JSON / 函数调用？

默认推荐

若无明确信号 → 使用该领域的标准默认模型。对于专业场景（推理、编程、 OCR、角色扮演、图像编辑等）以及各领域的比较，请参阅 [recommendation-matrix.md](references/recommendation-matrix.md)。

| 领域 | 默认 | 质量 | 速度 | 成本 | |---------------------|------------------|------------------|--------------------|--------------------| | text.chat | qwen3.7-plus | qwen3.8-max | qwen3.7-flash | qwen-turbo | | text.chat（均衡）| qwen3.7-plus | qwen3.7-max | qwen3.7-flash | qwen3.7-flash | | vision.analyze | qwen3.7-plus | qwen3.8-max | qwen3.8-flash | qwen3.8-flash | | omni（语音+视觉） | qwen3.5-omni-plus | qwen3.5-omni-plus | qwen3.5-omni-flash | — | | image.generate | wan2.7-image | qwen-image-3.0-pro | wan2.2-t2i-flash | wan2.2-t2i-flash · z-image-turbo（开源） | | image.edit | wan2.7-image | qwen-image-3.0-pro | wan2.5-i2i-preview | wan2.5-i2i-preview | | video.t2v | happyhorse-1.1-t2v | wan2.7-t2v | happyhorse-1.1-t2v | — | | video.i2v | happyhorse-1.1-i2v | wan2.7-i2v | happyhorse-1.1-i2v | — | | video.edit | wan2.7-videoedit | wan2.7-videoedit | happyhorse-1.0-video-edit | — | | audio.tts | qwen-audio-3.0-tts-plus | qwen-audio-3.0-tts-plus | cosyvoice-v3.5-flash | qwen3-tts-flash |

降级：如果此 skill 未加载，每个执行 skill 都会回退到其自身的内置
默认值。此协议仅起增量增强作用——可改进模型选择，但绝不会阻塞执行。

CLI 快速参考

必须进行身份验证。 所有 models 和 usage 命令都需要有效的 CLI 会话（通过浏览器
进行设备流登录——并非 API 密钥）。如果命令返回 Not authenticated / AUTH_REQUIRED：
1. 执行 3 步设备流登录流程，详见 [cli-usage.md](references/cli-usage.md#authentication-3-step-login-flow)
（使用适合该操作系统的命令主动打开验证 URL，然后立即轮询）。
2. 在 success 后重试原始命令。
3. 不得向用户索要 $DASHSCOPE_API_KEY / $QIANWEN_API_KEY——二者用于模型 API
调用，而非 CLI 会话。请参阅上文的[安全与凭证模型](#security--credential-model)。
4. 不得静默回退到快照。
Token Plan（sk-sp- 密钥）：通过设备流登录建立有效的 CLI 会话后，
qianwen usage 命令会同时报告按量付费用量和 Token Plan 席位额度 /
共享套餐点数，均针对已登录账户。要购买共享套餐、调整
席位或查看完整的账单历史记录，请引导用户前往
Token Plan 订阅控制台。
Token Plan 中模型的可用情况（文本 + 图像 + 视频 + TTS）详见
[recommendation-matrix.md](references/recommendation-matrix.md#token-plan-models).

| 需求 | 命令 | |-------------------------------|------------------------------------------------------------------| | 完整模型目录 | qianwen models list --all --format json | | 按模态筛选 | qianwen models list --input image --output text --format json | | 单个模型详情 | qianwen models info <model-id> --format json | | 关键词搜索 | qianwen models search "<query>" --format json | | 剩余免费额度 | qianwen usage free-tier --format json | | 认证状态 | qianwen auth status --format json |

显示规则：解析 --format json 输出并提供易于阅读的摘要；严禁直接输出原始 JSON。原样显示 --format text 输出，然后在 --- 之后添加分析。详情请参阅 [cli-usage.md](references/cli-usage.md#agent-display-rules-for-cli-output)。

CLI 错误处理——快速指南

CLI 执行失败时，先分类、再恢复，然后重试。禁止静默回退到快照。

| 类别 | 恢复措施（摘要） | |-------------------|--------------------------------------------------------------------------------| | auth-failure | 执行 3 步登录 → 重试原始命令。仅当用户拒绝时才回退。 | | not-installed | 显示安装命令 → 请用户安装 → 重试。不得静默使用快照。 | | model-not-found | 运行 qianwen models search "<keyword>" → 推荐前 3 个结果 → 使用正确的 ID 重试。 | | network-timeout | 等待 2s 后重试一次；仅在第二次失败后才询问是否回退。 | | quota-exhausted | 显示计费控制台；不得使用快照。 | | version-mismatch| 建议运行 qianwen version --check 或使用更新检查 skill → 升级 → 重试。 | | other | 显示原始 stderr；提供文档链接；仅在用户选择退出后才回退。 |

完整的分类、信号和示例流程：[error-handling.md](references/error-handling.md)。

定价与成本估算（仅限 PAYG）

如果使用 Token Plan，请跳过本节。

  • 最新定价：先运行 qianwen models info <model> --format json；仅将 pricing.md 用作

    • 离线回退方案。不得编造价格。

  • 强制要求的免责声明：每个与成本相关的回答都必须以

    • [pricing-disclaimer.md](references/pricing-disclaimer.md) 中的免责声明结尾（中文或英文版本，与 用户的回复语言一致）。遗漏免责声明属于严重失败。

  • 免费额度：不得假定免费额度可用——使用 qianwen usage free-tier 进行验证，或

    • 将用户引导至控制台。

  • 用量 / 账单查询：将用户引导至相应的控制台页面——请参见以下文件中的表格：

    • [pricing-disclaimer.md](references/pricing-disclaimer.md#usage--billing-console).

更新检查

当用户要求检查更新（“检查更新”、“检查版本”、“是否有新版本”、 “更新 skills”）时：

  1. 查找 qianwen-update-check：在同级 skill 目录中查找 qianwen-update-check/SKILL.md。
  2. 如果找到 — 运行：python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response

    3. 并报告结果。如果用户要求强制检查，请使用 --force。

  3. 如果未找到 — 运行 qianwen version --check 并报告结果。

反模式

  • 禁止编造模型名称 — 只能推荐此 skill 中列出的模型或 CLI 返回的模型。
  • 不得根据请求措辞推断 API 密钥类型 — 使用已配置的密钥或调用上下文。
  • 严禁推荐超出用户计费范围的模型 — Token Plan 密钥必须仅使用

    • [Token Plan 列表](references/recommendation-matrix.md#token-plan-models)中的模型；PAYG 密钥可使用完整模型目录。违反此要求会导致用户侧发生硬失败。

  • 严禁编造或猜测任何价格数值 — 只能使用 CLI / pricing.md / 官方定价页面。

    • 编造价格属于严重失败。

  • CLI 出错时，严禁静默回退到快照 — 必须先执行

    • [error-handling.md](references/error-handling.md) 中的恢复措施。

  • 严禁假定免费额度可用 — 额度可能已用尽、过期或被取消。始终先

    • 展示付费单价。

  • 严禁以明文形式输出 API 密钥 — 参见“安全”部分。
  • 严禁混淆 CLI 会话与 API 密钥 — CLI 身份验证采用浏览器设备流登录；严禁将

    • $DASHSCOPE_API_KEY 或 $QIANWEN_API_KEY 作为 CLI Not authenticated / AUTH_REQUIRED 错误的修复方案。

  • 严禁主动获取 URL 内容或触发网络搜索 — 仅当 CLI 与

    • 快照均无法作答，且用户确认后，才可访问在线来源。

  • 严禁构造用量/账单/控制台 URL — 只能使用此 skill 或其

    • 参考资料中列出的确切链接。若某个 URL 未列出，不得编造。

  • 始终包含成本免责声明，适用于任何与成本相关的回答（参见

    • [pricing-disclaimer.md](references/pricing-disclaimer.md)).

参考资料

| 来源 | 用途 | |--------------------------------------------------------------|------------------------------------------------------------------| | [cli-usage.md](references/cli-usage.md) | CLI 优先策略、3 步登录、显示规则、模型详情 URL | | [error-handling.md](references/error-handling.md) | CLI 错误分类与恢复 | | [recommendation-matrix.md](references/recommendation-matrix.md) | 完整推荐表、跨 Skill 决策、Token Plan、思考模式 | | [pricing-disclaimer.md](references/pricing-disclaimer.md) | 定价指南 + 强制免责声明 + 账单控制台链接 | | [pricing.md](references/pricing.md) | 定价结构概览（离线快照） | | [model-list.md](references/model-list.md) | 模型目录（离线快照） | | [sources.md](references/sources.md) | 官方文档 URL | | qianwen models list --format json | 动态数据：包含定价、功能和配额的完整模型目录 | | qianwen models info <id> --format json | 动态数据：单个模型的详细信息（阶梯定价、上下文、速率限制） | | qianwen models search "<q>" --format json | 动态数据：基于关键词发现模型 | | qianwen usage free-tier --format json | 动态数据：各模型的剩余免费额度 |

qianwen skills install @qianwen-ai/qianwen-model-selector