SuperAPI AI 工具集

qwencloud-payment

通用与其它

查看项目

更新于 10-16 04:57

技能介绍

用途:管理 QwenCloud 账户的支付方式状态、绑卡与消费限额,适用于用户询问支付方式、绑卡、消费限额或支付状态的场景。

前置条件:需安装 QwenCloud CLI 1.3.0 及以上版本,可用 qwencloud version 验证;未安装时运行 npm install -g @qwencloud/qwencloud-cli,并要求 Node.js 18 以上。所有计费命令均需认证。

认证流程:CLI 会自动检测非 TTY 环境并安全降级。三步路径为:qwencloud auth status --format json,若返回 authenticated: true 则直接执行命令;否则 qwencloud auth login --init-only --format json,提取 verification_url 在浏览器打开;再执行 qwencloud auth login --complete --format json 轮询至成功事件。两阶段登录细节可参考 qwencloud-usage 或 qwencloud-ops-auth 技能文档。

主要能力:查询支付方式用 qwencloud billing payment-method list --format json,仅 status 为 VALID 的条目视为有效;查询消费限额用 qwencloud billing limit --format json,返回已配置限额与当前消耗,状态为 INACTIVE 时说明尚未配置限额。展示大数值时可用 K=1000、M=1000000 格式。

绑卡:qwencloud billing payment-method bind --format json 仅打开官方网页控制台绑卡页面,不在对话内提交卡数据或执行交易。执行前必须说明影响并等待用户明确确认,未确认时返回 confirmation_required 且不执行。

输出与错误处理:命令默认返回 JSON,应始终传 --format json,解析后以人类可读摘要呈现,不要直接输出原始 JSON,分析内容放在摘要之后并用 --- 分隔。认证失败时返回原始错误,不要循环重试登录;登录成功后仅重试一次失败命令;网络错误提示检查连接;未知错误返回原始 stderr。结果状态包括 success、partial、empty、confirmation_required、error。禁止在未确认时绑卡、在对话内提交卡数据或交易、无明确标准判定支付方式不足、处理支持工单、查询账单历史或用量、查询订阅状态,以及认证失败时循环重试登录。