QianWen Payment

Security Boundary

[!CAUTION] This skill NEVER completes any fund operation inside the conversation. Recharge is only completed by the user on the official page opened by the CLI.

Before running

qianwen billing balance recharge

, you MUST, in order:

1. Show the user their current balance (

   qianwen billing balance summary --format json

   )
2. Explain that the recharge command will attempt to open the official recharge page in the browser, and will return a link to that page
3. Obtain the user's explicit confirmation (report result status as

   confirmation_required

   until confirmed)

The command attempts to open the browser the moment it runs — asking after execution is too late. (In sandboxed/headless hosts the browser may not open; the returned

rechargeUrl

is the reliable fallback — see Recharge entry below.)

• ❌ Run

  qianwen billing balance recharge

  before the user explicitly confirms — NEVER execute first and ask afterwards
• ❌ Perform, simulate, or promise any payment, transfer, or fund operation in the conversation
• ❌ Judge that the balance is "insufficient" or proactively suggest recharging — only display the balance as-is
• ❌ Construct, guess, or rewrite any recharge URL — only use the

  rechargeUrl

  returned by the CLI

Prerequisites

• QianWen CLI >= 1.3.0 is required. Verify with:

qianwen version

npm install -g @qianwenai/qianwen-cli

Authentication

1. qianwen auth status --format json

   →

   authenticated: true

   → skip to commands

2. qianwen auth login --init-only --format json

   → extract

   verification_url

   → open in browser

3. qianwen auth login --complete --format json

   → poll until

   success

   event

Commands

--format json

Check balance

qianwen billing balance summary

qianwen billing balance summary --format json

{
  "availableAmount": "1234.56",
  "currency": "CNY"
}

¥1,234.56

displayAmount

Recharge entry (confirmation required)

qianwen billing balance recharge

qianwen billing balance recharge --format json

{
  "rechargeUrl": "https://platform.qianwenai.com/home/billing/overview?target=recharge",
  "opened": true,
  "message": "Recharge page opened in browser"
}

rechargeUrl

opened

opened

opened

true

opened

opened

• true

  → tell the user the official recharge page has been opened in their browser, and still include the

  rechargeUrl

  with a note like "if it didn't open automatically, use this link".

• false

  → tell the user the browser could not be opened automatically, and show the

  rechargeUrl

  so they can open it manually.

rechargeUrl

Output and Agent Display Rules

--format json

--format json

1. Parse the JSON and extract the relevant data for the user's question
2. Present a human-readable summary — do not dump raw JSON to the user
3. Add analysis AFTER the summary — clearly separated with

   ---

--format text

1. Display CLI output EXACTLY AS-IS — no modification, no reformatting
2. Preserve all formatting — alignment, spacing, separators
3. Add analysis AFTER output only — clearly separated with

   ---

table

• ❌ Dump raw JSON to the user without interpretation
• ❌ Reformat or summarize text/table output
• ❌ Add prefixes like "Here's your balance:"
• ❌ Convert text/table output to bullet points
• ❌ Fabricate or mock values to fill in missing real results

Result status mapping

success

partial

null

empty

confirmation_required

error

Error Handling / Exit Codes

• On a non-zero exit code, still attempt to parse any structured output on stdout first — it may contain a usable error payload or partial result.
• On exit code 2 (authentication error): guide the user through the auth flow (see Prerequisites), then retry the original task at most once. NEVER loop login attempts.

Regional Note

platform.qianwenai.com

payment-method

bind