跳转到主要内容
千问 AI 平台 home page
文档
开始使用

CLI 工具

千问 AI 平台管理命令行工具，用于管理模型目录、账号、用量、账单、订阅和支持工单

版本 1.3.0
千问 AI 平台 CLI 已开源，欢迎查看源码、提交 Issue 或参与贡献：GitHub

快速开始

需要 Node.js 18 或更高版本。npm 包名及可安装版本以实际发布页为准。
  1. 安装并验证：
npm install -g @qianwenai/qianwen-cli
qianwen version
  1. 交互式登录：
qianwen auth login
  1. 执行第一条查询：
qianwen models list
不带参数运行 qianwen 进入交互模式；带命令运行时执行一次后退出。 无需预设环境变量；登录流程会保存管理凭证。models list 返回结果即表示安装、网络与登录均可用。Agent 可运行 qianwen config set output.format json 固定 JSON 输出；验证失败时运行 qianwen doctor --format json。

模型与文档

想筛选可用模型、核对模型详情，或从官方文档找到接入说明？从这里开始。

models list

列出可用模型，并按输入、输出模态筛选。 
qianwen models list [--input <text|image|video|audio|vector>] [--output <text|image|video|audio|vector>] [--page <integer>] [--per-page <integer>] [--all] [--verbose] [--format <auto|table|json|text>]

qianwen models list --input image --output text
qianwen models list --all --verbose --format json
Flag类型必填默认说明
--input <modality>枚举否未设置输入模态：text、image、video、audio、vector
--output <modality>枚举否未设置输出模态：text、image、video、audio、vector
--page <integer>整数否1页码；小于 1 时归一为 1
--per-page <integer>整数否20每页模型数；小于 1 时归一为 1
--all布尔否false返回全部模型并关闭分页；强制 JSON
--verbose布尔否false补充详情字段；强制 JSON
JSON 输出结构示例（示例值仅用于说明字段）： 
{
  "models": [
    {
      "id": "qwen3.6-plus",
      "modality": {
        "input": ["text", "image"],
        "output": ["text"]
      },
      "can_try": true,
      "free_tier": {
        "mode": "standard",
        "quota": {
          "remaining": 850000,
          "total": 1000000,
          "unit": "tokens",
          "used_pct": 15,
          "status": "valid",
          "resetDate": "2026-08-01T00:00:00.000Z"
        }
      },
      "pricing": {
        "tiers": [
          {
            "label": "输入<=256k",
            "input": 1.6,
            "output": 6.4,
            "cache_creation": 2,
            "cache_read": 0.16,
            "unit": "CNY/1M tokens"
          },
          {
            "label": "256k<输入<=1m",
            "input": 4.8,
            "output": 19.2,
            "cache_creation": 6,
            "cache_read": 0.48,
            "unit": "CNY/1M tokens"
          }
        ],
        "summary": {
          "cheapest_input": 1.6,
          "cheapest_output": 6.4,
          "unit": "CNY/1M tokens",
          "billing_type": "token"
        }
      },
      "features": ["function-calling"],
      "context": {
        "context_window": 131072,
        "max_input": 122880,
        "max_output": 8192
      }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}
找到候选模型后，运行 qianwen models info <id> 查看完整定价、上下文和限流信息。

models info

查看一个模型的完整详情；位置参数和 --model 至少提供一个。 
qianwen models info [id] [--model [id]] [--format <auto|table|json|text>]

qianwen models info qwen3.6-plus
qianwen models info --model qwen3.6-plus --format json
Flag / 参数类型必填默认说明
[id]字符串条件必填无模型 ID
--model [id]字符串条件必填无模型 ID；与位置参数二选一
需要继续比较候选模型时，运行 qianwen models search <query> 缩小范围。 按关键词或模态搜索模型。 
qianwen models search <query> [--page <integer>] [--per-page <integer>] [--all] [--format <auto|table|json|text>]

qianwen models search "function calling"
qianwen models search image --all --format json
Flag / 参数类型必填默认说明
<query>字符串是无搜索词
--page <integer>整数否1页码
--per-page <integer>整数否20每页模型数
--all布尔否false返回全部匹配项；强制 JSON
搜索官方文档，可直接查看当前结果中的第 N 条。 
qianwen docs search <query> [--limit <integer>] [--page <integer>] [--language <en|zh>] [--view <integer>] [--format <auto|table|json|text>]

qianwen docs search "chat completions" --language zh --limit 10
qianwen docs search "API Key" --view 1
Flag / 参数类型必填默认说明
<query>字符串是无搜索词
--limit <integer>整数否20JSON/text 每页 1-100 条；table 模式最多 5 条
--page <integer>整数否1页码
--language <en|zh>字符串（en/zh）否zh文档语言；其他值静默回退为 zh
--view <integer>整数否未设置查看当前结果中从 1 开始的序号
找到目标条目后，运行 qianwen docs view <path-or-url> 阅读正文。

docs view

按文档路径或 URL 查看页面内容。 
qianwen docs view <path-or-url> [--format <auto|table|json|text>]

qianwen docs view /docs/model-api
参数类型必填默认说明
<path-or-url>字符串是无文档路径或 URL

认证、账号与空间

想登录、确认凭证是否有效，或检查账号能访问哪些空间？用这组命令。

auth login

登录并保存凭证；交互式终端优先 PKCE，非交互环境使用 Device Flow。 
qianwen auth login [--init-only] [--complete] [--timeout <seconds>] [--format <auto|table|json|text>]

qianwen auth login
qianwen auth login --init-only --format json
qianwen auth login --complete --timeout 180
Flag类型必填默认说明
--init-only布尔否false输出授权信息后立即退出
--complete布尔否false继续并完成待处理的登录会话
--timeout <seconds>整数否120--complete 的轮询超时秒数
非 TTY 且未指定 --init-only/--complete 时自动按 init-only 方式返回。凭证优先写入系统钥匙串，不可用时回退到加密文件。也可以直接运行 qianwen login。 登录成功后，运行 qianwen auth status --format json 检查凭证，再运行 qianwen models list 验证查询权限。

auth status

检查本地凭证及服务端验证状态。 
qianwen auth status [--format <auto|table|json|text>]

qianwen auth status --format json
完整 JSON 结构示例： 
{
  "authenticated": true,
  "server_verified": true,
  "auth_mode": "device_flow",
  "source": "keychain",
  "user": {
    "aliyunId": "example-user"
  },
  "token": {
    "expires_at": "2026-08-01T00:00:00.000Z",
    "scopes": ["inference:read", "usage:read", "config:write"]
  }
}
服务端不可达但本地凭证仍有效时，server_verified 为 false，并可能带 warning；未登录或凭证过期时退出码为 2。 若 authenticated 为 false，重新运行 qianwen auth login。

auth logout

注销并删除本地凭证。也可以直接运行 qianwen logout。 
qianwen auth logout [--format <auto|table|json|text>]

qianwen auth logout

workspace list

列出当前账号可访问的空间。 
qianwen workspace list [--format <auto|table|json|text>]

qianwen workspace list --format json
列出空间后，运行 qianwen workspace limit 判断账号是否还能新增空间。

workspace limit

查看已用空间数与账号硬上限。 
qianwen workspace limit [--format <auto|table|json|text>]

qianwen workspace limit

用量、账单与订阅

想知道本月用了多少、花了多少、哪个模型或 API Key 成本最高，或订阅额度还剩多少？用这组命令。
日期选项以各命令表为准：usage summary 的日期只作用于 PAYG，usage free-tier 当前仅返回快照；其余相关查询按 --from/--to > --days > --period > 本月至今解析。常用 --period 值包括 today、yesterday、week、month、last-month、quarter、year 和 YYYY-MM。

usage summary

汇总免费额度、Token Plan 与按量付费用量。 
qianwen usage summary [--from <date>] [--to <date>] [--period <preset>] [--format <auto|table|json|text>]

qianwen usage summary --period month
qianwen usage summary --from 2026-07-01 --to 2026-07-21 --format json
Flag类型必填默认说明
--from <date>日期否当月首日PAYG 开始日期，YYYY-MM-DD
--to <date>日期否今天PAYG 结束日期，YYYY-MM-DD
--period <preset>字符串否monthPAYG 预设区间或 YYYY-MM
日期参数及 JSON 顶层 period 仅界定 pay_as_you_go；free_tier 与 token_plan 为查询时的当前快照。 完整 JSON 结构示例（示例值仅用于说明字段）： 
{
  "period": {
    "from": "2026-07-01",
    "to": "2026-07-21"
  },
  "free_tier": [
    {
      "model_id": "qwen-plus",
      "quota": {
        "remaining": 850000,
        "total": 1000000,
        "unit": "tokens",
        "used_pct": 15,
        "status": "valid",
        "resetDate": "2026-08-01T00:00:00.000Z"
      }
    }
  ],
  "token_plan": {
    "subscribed": true,
    "planName": "Token Plan",
    "status": "valid",
    "totalCredits": 25000,
    "remainingCredits": 18000,
    "usedPct": 28,
    "resetDate": "2026-08-01T00:00:00.000Z"
  },
  "pay_as_you_go": {
    "models": [
      {
        "model_id": "qwen-plus",
        "usage": {
          "tokens": 600000
        },
        "cost": 0.38,
        "currency": "CNY"
      }
    ],
    "total": {
      "cost": 0.38,
      "currency": "CNY"
    }
  }
}
发现某个模型用量异常时，运行 qianwen usage breakdown --model <id>；需要查看请求级原因时，继续用 qianwen usage logs。

usage breakdown

查看指定模型按日、月或季度拆分的按量付费用量。 
qianwen usage breakdown --model <id> [--granularity <day|month|quarter>] [--from <date>] [--to <date>] [--period <preset>] [--days <number>] [--format <auto|table|json|text>]

qianwen usage breakdown --model qwen-plus --days 7
qianwen usage breakdown --model qwen-plus --granularity month --period quarter
Flag类型必填默认说明
--model <id>字符串是无模型 ID；运行时校验
--granularity <g>枚举否dayday、month、quarter
--from <date>日期否未设置开始日期
--to <date>日期否未设置结束日期
--period <preset>字符串否month预设区间
--days <number>数值否未设置向前回看天数；请传正整数，CLI 当前未严格校验整数性

usage free-tier

浏览全部模型的当前免费额度状态。 
qianwen usage free-tier [--from <date>] [--to <date>] [--period <preset>] [--format <auto|table|json|text>]

qianwen usage free-tier --format json
Flag类型必填默认说明
--from <date>日期否未设置已注册；当前不影响返回的额度快照
--to <date>日期否未设置已注册；当前不影响返回的额度快照
--period <preset>字符串否未设置已注册；当前不影响返回的额度快照
该命令始终返回当前免费额度快照；日期 Flag 当前不会筛选历史额度。

usage payg

浏览全部模型的按量付费用量。 
qianwen usage payg [--from <date>] [--to <date>] [--period <preset>] [--days <number>] [--format <auto|table|json|text>]

qianwen usage payg --period last-month
qianwen usage payg --days 30 --format json
Flag类型必填默认说明
--from <date>日期否未设置开始日期
--to <date>日期否未设置结束日期
--period <preset>字符串否month预设区间
--days <number>数值否未设置向前回看天数；请传正整数，CLI 当前未严格校验整数性

usage logs

按时间、模型、状态或请求 ID 查询调用日志。 
qianwen usage logs [--from <date-or-rfc3339>] [--to <date-or-rfc3339>] [--period <preset>] [--model <id>]... [--status <type>]... [--request-id <id>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qianwen usage logs --period 24h --status 4xx --status 5xx
qianwen usage logs --request-id 12345-abcdef --format json
Flag类型必填默认说明
--from <value>日期/时间否7 天前 00:00YYYY-MM-DD 或 RFC3339
--to <value>日期/时间否当前时间YYYY-MM-DD 或 RFC3339
--period <preset>字符串否未设置支持 1h、24h、7d 及日期预设
--model <id>可重复字符串否未设置模型过滤，可重复
--status <type>可重复字符串否未设置支持 0/cancel、2xx/success、4xx/client-error、5xx/server-error 及别名；未知值被忽略
--request-id <id>字符串否未设置精确请求 ID；设置后忽略其他过滤项
--page <integer>整数否1页码
--page-size <integer>整数否20每页 1-100 条
单次时间跨度最多 14 天。

billing summary

按结算月份汇总账单金额。 
qianwen billing summary [--from <yyyy-mm>] [--to <yyyy-mm>] [--charge-type <all|subscription|payg>] [--format <auto|table|json|text>]

qianwen billing summary --from 2026-06 --to 2026-07
Flag类型必填默认说明
--from <yyyy-mm>月份否当前月起始结算月
--to <yyyy-mm>月份否当前月结束结算月，含当月
--charge-type <type>枚举否allall、subscription、payg
需要定位费用来源时，运行 qianwen billing breakdown --group-by model 或 --group-by api-key。

billing breakdown

按模型或 API Key 拆分消费。 
qianwen billing breakdown [--granularity <day|month>] [--group-by <model|api-key>] [--from <date>] [--to <date>] [--period <preset>] [--charge-type <all|subscription|payg>] [--top <integer>] [--format <auto|table|json|text>]

qianwen billing breakdown --group-by api-key --top 20
qianwen billing breakdown --granularity day --period week
Flag类型必填默认说明
--granularity <g>字符串（day/month）否monthday 或 month；其他值静默回退为 month
--group-by <dim>枚举否modelmodel 或 api-key
--from <date>日期/月否当前月day 使用 YYYY-MM-DD；month 可用 YYYY-MM
--to <date>日期/月否当前月结束日期或月份
--period <preset>字符串否未设置预设区间；短于 31 天时可自动采用 day
--charge-type <type>枚举否allall、subscription、payg
--top <integer>整数否10返回前 N 项，最大 100
day 最多跨 31 天，month 最多跨 12 个月。

billing limit

查看消费上限和告警配置。 
qianwen billing limit [--format <auto|table|json|text>]

qianwen billing limit --format json

billing balance summary

查看账号可用余额。 
qianwen billing balance summary [--format <auto|table|json|text>]

qianwen billing balance summary
余额不足时，运行 qianwen billing balance recharge 打开充值页。

billing balance recharge

打开充值页面；浏览器无法自动打开时仍输出链接。 
qianwen billing balance recharge [--format <auto|table|json|text>]

qianwen billing balance recharge

subscription status

汇总订阅状态；仅支持 Token Plan。 
qianwen subscription status [--plan <token>] [--format <auto|table|json|text>]

qianwen subscription status --plan token --format json
Flag类型必填默认说明
--plan <token>字符串（token）否全部支持的计划仅识别 token；其他值按未设置处理，不报错
使用团队 Token Plan 时，运行 qianwen subscription tokenplan seats --format json 查看席位实例。

subscription orders

列出订阅的购买、续费和升级订单。 
qianwen subscription orders [--from <date>] [--to <date>] [--type <purchase|renew|upgrade>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qianwen subscription orders --type purchase --page 1 --page-size 20
Flag类型必填默认说明
--from <date>日期否未设置开始日期，YYYY-MM-DD
--to <date>日期否未设置结束日期，YYYY-MM-DD
--type <kind>字符串否未设置识别 purchase、renew、upgrade；其他值按未设置处理，不报错
--page <integer>整数否1页码
--page-size <integer>整数否20每页 1-100 条

subscription tokenplan status

查看 Token Plan 席位类型、周期、续费状态与诊断信息。 
qianwen subscription tokenplan status [--format <auto|table|json|text>]

qianwen subscription tokenplan status --format json

subscription tokenplan seats

分页列出 Token Plan 席位实例。 
qianwen subscription tokenplan seats [--spec-type <pro|standard>] [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qianwen subscription tokenplan seats --spec-type pro --format json
Flag类型必填默认说明
--spec-type <type>枚举否未设置pro 或 standard
--page <integer>整数否1页码
--page-size <integer>整数否20每页最多 100 条
该命令未显式指定格式时默认使用 table；Agent 应显式传 --format json。

配置、诊断与补全

想固定机器可读输出、排查本地环境、启用 Shell 补全或确认版本？用这组命令。

config list

列出用户可配置项；1.3.0 公开键仅有 output.format。 
qianwen config list [--format <auto|table|json|text>]

qianwen config list --format json

config get

读取一个配置值。 
qianwen config get <key> [--format <auto|table|json|text>]

qianwen config get output.format

config set

设置一个配置值。 
qianwen config set <key> <value> [--format <auto|table|json|text>]

qianwen config set output.format json
output.format 可取 auto、table、json、text。 设置后运行 qianwen config get output.format 确认生效。

config unset

删除配置值并恢复默认行为。 
qianwen config unset <key> [--format <auto|table|json|text>]

qianwen config unset output.format

doctor

检查版本、认证、Token、网络、Shell 补全和全局配置。 
qianwen doctor [--format <auto|table|json|text>]

qianwen doctor --format json
按诊断结果修复后重新运行 qianwen doctor，直到失败项消失。

completion install

为当前或指定 Shell 安装命令补全。 
qianwen completion install [--shell <bash|zsh|fish>]

qianwen completion install --shell zsh

completion generate

输出当前或指定 Shell 的补全脚本。 
qianwen completion generate [--shell <bash|zsh|fish>]

qianwen completion generate --shell bash
--shell 省略时自动检测，支持 bash、zsh、fish。

version

输出版本；--check 同时检查新版本。 
qianwen version [--check]

qianwen version --check

支持与更新

想提交并跟进问题、关闭或评价工单，或检查 CLI 更新？从这里选择动作。

support list

分页列出支持工单。 
qianwen support list [--page <integer>] [--page-size <integer>] [--format <auto|table|json|text>]

qianwen support list --page 1 --page-size 10
Flag类型必填默认说明
--page <integer>整数否1页码
--page-size <integer>整数否10每页 1-10 条

support view

查看工单详情和消息记录。 
qianwen support view <ticket-id> [--format <auto|table|json|text>]

qianwen support view TICKET_ID --format json

support create

交互式创建工单，或用成对参数进行非交互创建。 
qianwen support create [--list-categories] [--category-id <id>] [--description <text>] [--format <auto|table|json|text>]

qianwen support create --list-categories
qianwen support create --category-id CATEGORY_ID --description "问题描述"
Flag类型必填默认说明
--list-categories布尔否false列出分类后退出
--category-id <id>字符串非交互条件必填无与 --description 同时提供
--description <text>字符串非交互条件必填无最长 2000 字符，超长截断
未提供完整的非交互参数时需要 TTY。 创建成功后保存返回的工单 ID，并运行 qianwen support view <ticket-id> 跟进处理记录。

support reply

回复工单；非交互环境必须提供消息正文。 
qianwen support reply <ticket-id> [--message <text>] [--format <auto|table|json|text>]

qianwen support reply TICKET_ID --message "请检查日志"
Flag / 参数类型必填默认说明
<ticket-id>字符串是无工单 ID
--message <text>字符串非交互必填无最长 2000 字符，超长截断

support close

关闭工单；脚本中必须用 --yes 跳过确认。 
qianwen support close <ticket-id> [--yes] [--format <auto|table|json|text>]

qianwen support close TICKET_ID --yes
Flag / 参数类型必填默认说明
<ticket-id>字符串是无工单 ID
--yes布尔非交互必填false跳过确认

support rate

对已解决工单评分；评分范围为 0-2。 
qianwen support rate <ticket-id> [--rating <0|1|2>] [--comment <text>] [--format <auto|table|json|text>]

qianwen support rate TICKET_ID --rating 2 --comment "满意"
Flag / 参数类型必填默认说明
<ticket-id>字符串是无工单 ID
--rating <n>整数非交互必填无0=不满意，1=一般，2=满意
--comment <text>字符串否未设置最长 500 字符，超长截断

update

检查版本并输出升级提示，不直接安装。 
qianwen update

qianwen update

全局约定

qianwen [--format <auto|table|json|text>] [--quiet] <area> <verb> [args] [flags]
全局 Flag类型默认说明
--format <fmt>枚举auto显式格式优先于 config output.format
-q, --quiet布尔false静默 stdout/stderr，仅以退出码表示结果
-v, --version布尔false顶层版本快捷项
-h, --help布尔false顶层及各级命令帮助
auto 在 TTY 使用 table，在 pipe/重定向中使用 JSON；非 TTY 显式请求 table 时降级为 text 并在 stderr 提示。成功数据写 stdout，错误和诊断写 stderr。JSON 保留各命令及服务端字段，不提供统一外层 envelope；CliError 的退出码字段为 exit_code，Commander 参数错误仍可能使用 exitCode。 分页查询中，JSON 通常保留请求页并在越界时返回空数组；交互表格通常调整到有效页。Agent 应显式指定 --format json、页码和每页数量。
退出码含义
0成功
1通用错误；Commander 参数解析错误也使用 1
2认证失败
3网络错误
4配置或参数错误
5限流
6服务端错误
7资源未找到
8操作未完成的保留码
10docs view 文档未找到
130用户中断
具体命令的部分本地校验沿用通用错误码 1；脚本应以实际非零值判断失败，并结合 JSON 错误对象中的 code 分流。

附录

命令速查表

命令用途
qianwen auth login获取并保存管理凭证
qianwen auth logout删除本地凭证并注销
qianwen auth status检查凭证与服务端验证状态
qianwen models list筛选可用模型
qianwen models info查看单模型完整详情
qianwen models search按关键词或模态找模型
qianwen usage summary汇总各计费方式用量
qianwen usage breakdown拆分指定模型用量
qianwen usage free-tier检查免费额度余额
qianwen usage payg查看按量付费用量与成本
qianwen usage logs按请求或状态查调用日志
qianwen billing limit检查消费上限与告警
qianwen billing breakdown按模型或 API Key 拆账
qianwen billing summary查看月度结算总额
qianwen billing balance summary检查账号可用余额
qianwen billing balance recharge打开充值页面
qianwen subscription status确认 Token Plan 订阅状态
qianwen subscription orders查购买、续费和升级订单
qianwen subscription tokenplan status查周期与续费状态
qianwen subscription tokenplan seats逐页查看席位实例
qianwen workspace list列出可访问空间
qianwen workspace limit检查空间数量上限
qianwen support list分页查工单
qianwen support view查看工单与消息记录
qianwen support create提交新工单
qianwen support reply向工单追加消息
qianwen support close关闭工单请求
qianwen support rate评价已解决工单
qianwen docs search按关键词找官方文档
qianwen docs view打开文档正文
qianwen config list查看公开配置项
qianwen config get读取单项配置
qianwen config set设置默认输出格式
qianwen config unset恢复配置默认值
qianwen doctor定位版本、认证或网络问题
qianwen completion install启用 Shell 补全
qianwen completion generate导出 Shell 补全脚本
qianwen version查看版本并检查更新
qianwen update获取升级提示