quickmagic-cli 1.5.0 → 1.9.0

package/README.md

@@ -127,7 +127,8 @@ Ghi chú chung trước khi xem bảng:
 | Lệnh | Mô tả | Credit |
 |---|---|---|
 | `qm cutout` | Tách nền / PNG trong suốt / remix scene | Có |
-| `qm edit <image> --tool <t>` | restore / upscale (2k,4k) / beauty / muscle / color_boost | Có |
+| `qm edit <image> --tool <t>` | restore / beauty / muscle / color_boost (upscale → dùng `qm upscale`) | Có |
+| `qm upscale <file...> [--video]` | Upscale ảnh (2k/4k/8k) hoặc video (nâng nét/tăng fps) — 1 lệnh nhiều file = mỗi file 1 job | Có |
 
 ### Video quảng cáo / Marketing
 
@@ -147,7 +148,7 @@ Ghi chú chung trước khi xem bảng:
 | `qm subtitle <video_url>` | Thêm phụ đề (+ lồng tiếng, dịch) | Có |
 | `qm split <video_url>` | Cắt video dài → clip ngắn | Có |
 | `qm motion <video_url> --image <url...>` | Áp chuyển động video vào ảnh (Kling) | Có |
-| `qm tts (--text <t>\|--file <path>) --voice <v>` | Chuyển văn bản → giọng nói (5 model qimi_1.5/2.5/3/5/5.5) | Có |
+| `qm tts (--text <t>\|--file <path>) --voice <v>` | Chuyển văn bản → giọng nói (6 model qimi_1.5/2.5/3/3.5/5/5.5; qimi_3.5 có kiểu đọc `--style`) | Có |
 | `qm voices list --model <m>` | Liệt kê giọng theo model + giá (`pricing`) | — |
 | `qm voices clone --audio <file\|url> --name <n>` | Nhân bản giọng riêng (dùng cho qimi_5/5.5) | Có |
 | `qm voices delete <id>` | Xoá giọng đã clone | — |
@@ -164,6 +165,21 @@ Ghi chú chung trước khi xem bảng:
 | `qm import <url>` | Nhập ảnh/video từ link TikTok/Instagram | — |
 | `qm assets <kind>` | Liệt kê tài sản đã lưu: `products`\|`outfits`\|`kols` | — |
 
+### Ứng dụng web (React SSR trên `<slug>.quickmagic.app`)
+
+| Lệnh | Mô tả | Credit |
+|---|---|---|
+| `qm apps create --title "…" [--subdomain s] [--from <app_id>]` | Tạo app mới từ template (`--from` = remix app công khai đã duyệt) | — |
+| `qm apps list` | App của tôi | — |
+| `qm apps status <app_id> [--json]` | Trạng thái deploy/duyệt/build | — |
+| `qm apps repo-access <app_id>` | URL git clone có token 15 phút (push code) | — |
+| `qm apps deploy <app_id> [--wait]` | Build + deploy nhánh main | — |
+| `qm apps publish <app_id> [--unlist]` | Lên feed (cần cover; tự kiểm duyệt; app đầu tiên duyệt tay) | — |
+| `qm apps remove <app_id> --yes` | Xoá vĩnh viễn (subdomain khoá mãi) | — |
+
+Người dùng app trả credit của **chính họ** khi tạo ảnh/video trong app; bạn (creator) nhận 5% trên mỗi lượt.
+Không có `apps db` / `apps secrets` trên CLI (chỉ agent dùng qua MCP).
+
 ## Tạo ảnh
 
 ```bash
@@ -267,6 +283,13 @@ qm voices list --model qimi_1.5 --language "Tiếng Việt"
 qm tts --text "Xin chào Quick Magic" --voice <voice_id> --model qimi_3 --wait --out ./out
 qm voices clone --audio ./sample.wav --name "Giọng của tôi" --wait
 
+# Qimi 3.5 — giọng của qimi_3, giá cố định mỗi lần (xem dòng "Giá:" của qm voices list --model qimi_3.5), tối đa 30.000 ký tự, chọn kiểu đọc:
+#   --style: tối đa 1 tốc độ (fast|default|slow) + 1 cảm xúc (cheerful|sad|storytelling|emotional), nối bằng "+"
+#            hoặc tự mô tả tiếng Việt "custom:<mô tả ≤200 ký tự>"; bỏ trống = đọc tự nhiên
+qm voices list --model qimi_3.5
+qm tts --file ./truyen.txt --voice <voice_id> --model qimi_3.5 --style "slow+storytelling" --wait --out ./out
+qm tts --text "Ngày xửa ngày xưa..." --voice <voice_id> --model qimi_3.5 --style "custom:giọng trầm ấm, chậm rãi như kể chuyện đêm khuya" --wait --out ./out
+
 # Tạo nhạc AI — xem giá trước khi chạy (thường miễn phí giai đoạn ra mắt)
 qm music models
 qm music lyrics --desc "bài hát vui về buổi sáng cà phê Sài Gòn"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "quickmagic-cli",
-  "version": "1.5.0",
-  "description": "Quick Magic CLI — generate AI images/videos, product photoshoots, virtual try-on, hook ad videos, subtitles, text-to-speech/voice cloning, AI song generation and more via the Quick Magic REST API, with browser-based OAuth PKCE login (no API keys to manage). Ships with 10 Claude Agent Skills and an MCP server integration.",
+  "version": "1.9.0",
+  "description": "Quick Magic CLI — generate AI images/videos, product photoshoots, virtual try-on, hook ad videos, subtitles, text-to-speech/voice cloning, AI song generation, image upscaling and more via the Quick Magic REST API, with browser-based OAuth PKCE login (no API keys to manage). Ships with 11 Claude Agent Skills and an MCP server integration.",
   "bin": {
     "quickmagic": "src/index.js",
     "qm": "src/index.js"

package/skills/README.md

@@ -1,6 +1,6 @@
 # Quick Magic CLI — Agent Skills
 
-10 Agent Skills that wrap the `quickmagic` / `qm` CLI so a coding agent (Claude
+11 Agent Skills that wrap the `quickmagic` / `qm` CLI so a coding agent (Claude
 Code and compatible tools) can drive Quick Magic directly from the terminal —
 mirroring the `npx skills add higgsfield-ai/skills` pattern (`/higgsfield:generate`
 etc.), tailored to Quick Magic's own REST API and CLI.
@@ -18,7 +18,7 @@ when to load the skill).
 Option 1 — `npx skills` (if this repo is published as a skills package):
 
 ```bash
-npx skills add Tungbillee/cli-quickmagic --skills quickmagic-account,quickmagic-generate,quickmagic-product-photoshoot,quickmagic-fashion,quickmagic-cutout,quickmagic-hook-video,quickmagic-edit-image,quickmagic-subtitle-split,quickmagic-tts,quickmagic-music
+npx skills add Tungbillee/cli-quickmagic --skills quickmagic-account,quickmagic-generate,quickmagic-product-photoshoot,quickmagic-fashion,quickmagic-cutout,quickmagic-hook-video,quickmagic-edit-image,quickmagic-upscale,quickmagic-subtitle-split,quickmagic-tts,quickmagic-music
 ```
 
 Option 2 — copy directly into a project's or your user's Claude skills folder:
@@ -41,12 +41,13 @@ mkdir -p ~/.claude/skills && cp -r cli-quickmagic/skills/quickmagic-* ~/.claude/
 | `quickmagic-fashion` | `fashion`, `tryon` | outfit lookbook shoots vs. virtual try-on on a specific person photo |
 | `quickmagic-cutout` | `cutout` | transparent PNG cutouts / scene remix |
 | `quickmagic-hook-video` | `hook presets`, `hook video` | ~10s comedy ad video from a character + product photo (18 presets) |
-| `quickmagic-edit-image` | `edit` | restore / upscale (2k/4k) / beauty / muscle / color_boost on an existing image |
+| `quickmagic-edit-image` | `edit` | restore / beauty / muscle / color_boost on an existing image |
+| `quickmagic-upscale` | `upscale` | upscale images to 2K/4K/8K (crisp/standard/seedvr2/ultra) or videos (standard/pro/seedvr2/fps) |
 | `quickmagic-subtitle-split` | `subtitle`, `split` | auto subtitles/dubbing, long-video → short clips |
-| `quickmagic-tts` | `tts`, `voices list/clone/delete` | text-to-speech (5 models) + custom voice cloning |
+| `quickmagic-tts` | `tts`, `voices list/clone/delete` | text-to-speech (6 models; `qimi_3.5` adds reading styles — presets or your own Vietnamese description — at a flat price per call) + custom voice cloning |
 | `quickmagic-music` | `music create/lyrics/models/get` | AI song generation (vocals or instrumental) from a description or your own lyrics |
 
-## Shared conventions (all 10 skills)
+## Shared conventions (all 11 skills)
 
 - Check `qm auth status` first; if not logged in, tell the user to run
   `qm auth login`.
@@ -61,7 +62,7 @@ mkdir -p ~/.claude/skills && cp -r cli-quickmagic/skills/quickmagic-* ~/.claude/
   shortfall and a link to top up (https://quickmagic.vn/pricing).
 - Never poll `jobs get` manually — use `qm jobs wait <id> [--out dir]`. Note that
   `--out` only auto-downloads for job types with a single `result_url`
-  (image/video/tryon/edit/hook/subtitle/tts/music); product/fashion/cutout/split
+  (image/video/tryon/edit/upscale/hook/subtitle/tts/music); product/fashion/cutout/split
   return arrays and must be read back with `qm jobs get <id>` after
   completion, and voice-clone jobs (`voc_`) have no `result_url` at all (read
   `voice`/`sample_url`/`status` instead). See `quickmagic-account` for the

package/skills/quickmagic-account/SKILL.md

@@ -108,13 +108,16 @@ generating command's own `--wait` flag, where available).
 | `stt_` | `stt` | text result (no dedicated skill) |
 | `tts_` | `tts` | single `result_url` (mp3) + `model`/`voice`/`character` — see `quickmagic-tts` |
 | `voc_` | `voices clone` | **no** `result_url`: `voice` (name to use with `--voice`), `sample_url`, `is_free` — see `quickmagic-tts` |
+| `mus_` | `music create` | single `result_url` (mp3) + `title`/`duration_ms` — see `quickmagic-music` |
+| `ups_` | `upscale` (image) | single `result_url` — see `quickmagic-upscale` |
+| `vup_` | `upscale` (video, `--video`/auto-detected) | single `result_url` + `duration_sec` — see `quickmagic-upscale` |
 
 **Important caveat**: `jobs wait --out <dir>` only **auto-downloads** for the
-single-`result_url` types (`img_`/`vid_`/`vto_`/`edt_`/`hok_`/`sub_`/`tts_`). For the
-array types (`pai_`/`fsh_`/`cut_`/`spl_`) and `voc_` (voice clone — no file, read
-`voice`/`sample_url` via `qm jobs get`), `--out` still polls status correctly
-but downloads nothing — after status is `completed`, call `qm jobs get <id>` and
-read the array field yourself, then report each URL to the user.
+single-`result_url` types (`img_`/`vid_`/`vto_`/`edt_`/`hok_`/`sub_`/`tts_`/`mus_`/
+`ups_`/`vup_`). For the array types (`pai_`/`fsh_`/`cut_`/`spl_`) and `voc_` (voice
+clone — no file, read `voice`/`sample_url` via `qm jobs get`), `--out` still polls
+status correctly but downloads nothing — after status is `completed`, call
+`qm jobs get <id>` and read the array field yourself, then report each URL to the user.
 
 Statuses: `queued` → `in_progress` → `completed` (success) or `failed` (relay the
 job's `error` field). A `queued` status stuck past ~15 minutes is reported as

package/skills/quickmagic-edit-image/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: quickmagic-edit-image
 description: >-
-  Restore, upscale (2k/4k), beauty-retouch, muscle-enhance, or color-boost a
-  single existing image via `qm edit`. Use for enhancing an existing photo,
-  not generating a new one. Triggers: "upscale ảnh lên 4k", "phục hồi ảnh cũ",
-  "làm đẹp da trong ảnh", "chỉnh màu ảnh", "restore old photo", "upscale
-  image resolution".
+  Restore, beauty-retouch, muscle-enhance, or color-boost a single existing
+  image via `qm edit`. Use for enhancing an existing photo, not generating a new
+  one. For enlarging / sharpening (2k/4k/8k) use the `quickmagic-upscale` skill
+  (`qm upscale`) instead. Triggers: "phục hồi ảnh cũ", "làm đẹp da trong ảnh",
+  "chỉnh màu ảnh", "restore old photo", "retouch skin".
 ---
 
-# quickmagic-edit-image — Photo Restore / Upscale / Retouch
+# quickmagic-edit-image — Photo Restore / Retouch
+
+> Phóng to & làm nét ảnh đã tách sang skill `quickmagic-upscale` (`qm upscale`).
 
 Wraps `qm edit <image>`. Edits **one existing image** in place — restoring
 damage, upscaling resolution, beauty retouch, muscle enhancement, or color
@@ -18,22 +20,21 @@ grading. Not for generating a new image from a text prompt (use
 ## Command
 
 ```
-qm edit <image> --tool <t> [--model qimi_2.5|qimi_3] [--upscale-target 2k|4k] [--style <s...>] [--crid <id>]
+qm edit <image> --tool <t> [--model qimi_2.5|qimi_3] [--style <s...>] [--crid <id>]
 ```
 
 | Flag | Notes |
 |---|---|
 | `<image>` **required** (positional) | URL or local file path |
-| `--tool <t>` **required** | one of `restore` \| `upscale` \| `beauty` \| `muscle` \| `color_boost` |
+| `--tool <t>` **required** | one of `restore` \| `beauty` \| `muscle` \| `color_boost` |
 | `--model` | `qimi_2.5` or `qimi_3` (default `qimi_3`) |
-| `--upscale-target` | **required when `--tool upscale`** — `2k` or `4k` |
 | `--style <s...>` | **required when `--tool beauty`** — up to 3 style keywords, repeatable flag |
 | `--crid <id>` | idempotency key |
 
-Map the user's request to a tool: "ảnh cũ/rách/mờ" → `restore`; "phóng to/nét
-hơn/4K" → `upscale` (ask 2k or 4k if not specified); "làm đẹp da/mặt" → `beauty`
-(ask for up to 3 style keywords); "cơ bắp săn chắc hơn" → `muscle`; "màu sắc rực
-rỡ hơn" → `color_boost`.
+Map the user's request to a tool: "ảnh cũ/rách/mờ" → `restore`; "làm đẹp da/mặt"
+→ `beauty` (ask for up to 3 style keywords); "cơ bắp săn chắc hơn" → `muscle`;
+"màu sắc rực rỡ hơn" → `color_boost`. "Phóng to / nét hơn / 4K / 8K" KHÔNG thuộc
+lệnh này — dùng skill `quickmagic-upscale` (`qm upscale`).
 
 ## Before running
 
@@ -55,15 +56,14 @@ No `--wait` flag. Copy the job id from the hint
 ## Errors
 
 `Không đủ credit: ...` → state shortfall + https://quickmagic.vn/pricing.
-Missing `--upscale-target` on `upscale`, or missing `--style` on `beauty` →
-plain `Lỗi: <message>`; add the missing flag and retry. Full reference:
+Missing `--style` on `beauty` → plain `Lỗi: <message>`; add the flag and retry.
+`tool_moved` → tool `upscale` đã dời sang `qm upscale` (skill `quickmagic-upscale`). Full reference:
 `quickmagic-account` skill.
 
 ## Example
 
 ```bash
 qm edit ./old-photo.jpg --tool restore --model qimi_3
-qm edit ./portrait.jpg --tool upscale --upscale-target 4k
 qm edit ./selfie.jpg --tool beauty --style smooth-skin soft-light
 qm jobs wait edt_3 --out ./out
 ```

package/skills/quickmagic-tts/SKILL.md

@@ -2,12 +2,15 @@
 name: quickmagic-tts
 description: >-
   Convert text to speech, or clone a custom voice, via the Quick Magic CLI
-  (`qm tts`, `qm voices list/clone/delete`). Covers 5 TTS engines (qimi_1.5,
-  qimi_2.5, qimi_3, qimi_5, qimi_5.5) — the last two add 310 built-in system
-  voices across 16 languages plus optional user voice cloning. Triggers:
-  "đọc văn bản thành giọng nói", "chuyển text thành giọng nói", "clone giọng",
-  "tạo giọng riêng", "nhân bản giọng nói", "text to speech", "voice clone",
-  "TTS", "read this text aloud", "convert text to audio".
+  (`qm tts`, `qm voices list/clone/delete`). Covers 6 TTS engines (qimi_1.5,
+  qimi_2.5, qimi_3, qimi_3.5, qimi_5, qimi_5.5) — qimi_3.5 reads the qimi_3
+  voices with a chosen reading style (speed/emotion presets or your own
+  Vietnamese description), at a flat price per call; qimi_5/qimi_5.5 add 310
+  built-in system voices across 16 languages plus optional user voice
+  cloning. Triggers: "đọc văn bản thành giọng nói", "chuyển text thành giọng
+  nói", "đọc truyện", "giọng kể chuyện", "đọc chậm", "giọng vui tươi",
+  "clone giọng", "tạo giọng riêng", "nhân bản giọng nói", "text to speech",
+  "voice clone", "TTS", "read this text aloud", "convert text to audio".
 ---
 
 # quickmagic-tts — Text-to-Speech & Voice Cloning
@@ -19,7 +22,7 @@ text read aloud as audio, or wants a custom cloned voice for future TTS calls.
 
 | Command | Required flags | Key optional flags |
 |---|---|---|
-| `qm tts` | `--text <t>` or `--file <path>`, `--voice <v>` | `--model <m>` (default `qimi_3`), `--language <l>`, `--speed <n>` (0.5-2.0, qimi_5/qimi_5.5 only), `--style <s>`, `--title <t>`, `--crid <id>`, `--wait`, `--out <dir>` |
+| `qm tts` | `--text <t>` or `--file <path>`, `--voice <v>` | `--model <m>` (default `qimi_3`), `--language <l>`, `--speed <n>` (0.5-2.0, qimi_5/qimi_5.5 only), `--style <s>` (voice label for qimi_1.5/2.5/3; preset or `custom:<mô tả>` for qimi_3.5 — see "Reading styles"), `--title <t>`, `--crid <id>`, `--wait`, `--out <dir>` |
 | `qm voices list` | `--model <m>` | `--language <l>`, `--search <s>`, `--limit <n>` (default 50, max 100 — qimi_1.5 has 535 voices and qimi_5 310+: use `--language`/`--search` to narrow instead of paging) |
 | `qm voices clone` | `--audio <file\|url>`, `--name <n>` | `--crid <id>` (auto-generated if omitted), `--wait` |
 | `qm voices delete <id>` | `<id>` (`voc_12` or bare `12`) | — |
@@ -31,15 +34,18 @@ text read aloud as audio, or wants a custom cloned voice for future TTS calls.
 | `qimi_1.5` | flat credits/call | 50,000 | fixed catalog |
 | `qimi_2.5` | flat credits/call | 30,000 | fixed catalog |
 | `qimi_3` (default) | flat credits/call | 30,000 | fixed catalog |
+| `qimi_3.5` | flat credits/call | 30,000 | the `qimi_3` catalog (multilingual) + reading styles — no clones |
 | `qimi_5` | credits/character, with a minimum charge | 10,000 | 310 system voices (16 languages) + your own clones |
 | `qimi_5.5` | credits/character (higher quality), with a minimum charge | 10,000 | 310 system voices (16 languages) + your own clones |
 
-Reference only, as of 260817 — **never quote these from memory**. Always run
+Reference only, as of 260927 — **never quote these from memory**. Always run
 `qm voices list --model <m>` and read the `pricing` object from its response:
-roughly `qimi_1.5`/`qimi_2.5` ≈ 2cr/call, `qimi_3` ≈ 4cr/call, `qimi_5` ≈
-0.09cr/char, `qimi_5.5` ≈ 0.15cr/char (min ~5cr) — rates can change. Voice
-cloning is a separate, much larger flat charge (~2,230cr) — see "Cloning a
-custom voice" below.
+roughly `qimi_1.5`/`qimi_2.5` ≈ 2cr/call, `qimi_3` ≈ 4cr/call, `qimi_3.5` ≈
+10cr/call (any length up to 30,000 chars), `qimi_5` ≈ 0.09cr/char,
+`qimi_5.5` ≈ 0.15cr/char (min ~5cr) — rates can change. Per-character models
+count the text **after** your saved pronunciation replacements. Voice cloning
+is a separate, much larger flat charge (~2,230cr) — see "Cloning a custom
+voice" below.
 
 ## Pick a voice
 
@@ -55,6 +61,9 @@ qm voices list --model qimi_5 --search Minh --limit 20
 - `qimi_1.5`/`qimi_2.5`/`qimi_3` list a fixed catalog with a `STYLES` column
   (labels like "Vui vẻ"/"Formal") — pass the exact label as `--style`.
   `qimi_5`/`qimi_5.5` voices don't take `--style`.
+- `qimi_3.5` lists the same voices as `qimi_3` and
+  prints a `Kiểu đọc (style)` line — its `--style` is a reading style, not a
+  voice label (see "Reading styles" below).
 - `qimi_5`/`qimi_5.5` output splits into **"Giọng của bạn"** (voices you
   cloned) and **"Giọng hệ thống"** (310 system voices, 16 languages) —
   cloning is optional, try a system voice first. Each system voice reads
@@ -74,8 +83,28 @@ qm tts --file ./script.txt --voice <voice_id> --model qimi_5 --language "Tiếng
 - The CLI prints the character count before submitting; sanity-check it
   against the model's char limit above to avoid a `char_limit_exceeded`.
 - Without `--wait`, note the printed job id (`tts_<n>`) and run
-  `qm jobs wait tts_<n> --out ./out` separately — it auto-downloads the mp3
-  (single `result_url`).
+  `qm jobs wait tts_<n> --out ./out` separately — it auto-downloads the audio
+  file (mp3, or wav for qimi_3/qimi_3.5; single `result_url`).
+
+## Reading styles (qimi_3.5 only)
+
+```bash
+qm voices list --model qimi_3.5          # prints the price line + the live "Kiểu đọc (style)" hint
+qm tts --file ./truyen.txt --voice <voice_id> --model qimi_3.5 --style "slow+storytelling" --wait --out ./out
+qm tts --text "Ngày xửa ngày xưa..." --voice <voice_id> --model qimi_3.5 --style "custom:giọng trầm ấm, chậm rãi như kể chuyện đêm khuya" --wait --out ./out
+```
+
+- Preset: at most **one speed** (`fast` | `default` | `slow`) and **one
+  emotion** (`cheerful` | `sad` | `storytelling` | `emotional`), joined
+  with `+` — e.g. `slow`, `cheerful`, `slow+storytelling`. The server's
+  current list is the `Kiểu đọc (style)` line of `qm voices list --model qimi_3.5`.
+- Custom: `custom:<Vietnamese description>`, ≤200 characters after the
+  server removes quotes/brackets and turns line breaks into spaces. It only
+  changes tone, pace and emotion — the text is still read word for word.
+- Omit `--style` for a natural read. `--speed` does not apply to qimi_3.5 —
+  put the speed in `--style` instead.
+- An unknown key, two speeds, two emotions, or a custom text over 200
+  characters fails with `invalid_style` **before** any credit is held.
 
 ## Cloning a custom voice (optional, for qimi_5/qimi_5.5)
 
@@ -137,10 +166,10 @@ CLI prints `Lỗi [code]: message`. Common codes:
 
 | Code | Meaning | What to do |
 |---|---|---|
-| `invalid_model` | `--model` not one of the 5 keys (e.g. `v3`) | use `qimi_1.5|qimi_2.5|qimi_3|qimi_5|qimi_5.5` |
+| `invalid_model` | `--model` not one of the 6 keys (e.g. `v3`) | use `qimi_1.5|qimi_2.5|qimi_3|qimi_3.5|qimi_5|qimi_5.5` |
 | `voice_not_found` | bad/unknown `--voice` | re-pick from `qm voices list`; if the name repeats across languages, add `--language` |
-| `invalid_style` | `--style` isn't in that voice's `styles` | use the exact label from the `STYLES` column |
-| `invalid_speed` | outside 0.5-2.0, or `--speed` used with qimi_1.5/2.5/3 | clamp to range; only pass `--speed` for qimi_5/qimi_5.5 |
+| `invalid_style` | qimi_1.5/2.5/3: `--style` isn't in that voice's `styles`; qimi_3.5: unknown preset key, two speeds/emotions, or `custom:` text over 200 chars | use the exact `STYLES` label; for qimi_3.5 follow "Reading styles" |
+| `invalid_speed` | `--speed` outside 0.5-2.0 on qimi_5/qimi_5.5 (other models ignore `--speed`) | clamp to range; for qimi_3.5 use a speed preset in `--style` |
 | `char_limit_exceeded` | text longer than the model's char limit | split the text into smaller chunks |
 | `insufficient_credit` / `negative_balance` | not enough balance | state the exact shortfall and https://quickmagic.vn/pricing |
 | `rate_limited` / `concurrent_limit` / `busy` | too many requests/jobs right now | wait, then retry |
@@ -159,6 +188,9 @@ qm auth status
 qm voices list --model qimi_1.5 --language "Tiếng Việt"   # qimi_3 has no per-language labels (all "Đa ngôn ngữ (70+)") — omit --language for it
 qm tts --text "Chào mừng đến với Quick Magic." --voice <voice_id> --model qimi_3 --wait --out ./out
 
+qm voices list --model qimi_3.5
+qm tts --file ./truyen.txt --voice <voice_id> --model qimi_3.5 --style "slow+storytelling" --wait --out ./out
+
 qm voices list --model qimi_5
 qm voices clone --audio ./mysample.wav --name "Giọng riêng" --wait
 qm tts --text "Đọc bằng giọng của tôi." --voice "Giọng riêng" --model qimi_5 --wait --out ./out

package/skills/quickmagic-upscale/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: quickmagic-upscale
+description: >-
+  Upscale (sharpen + enlarge) one or more existing images to 2K/4K/8K, or
+  denoise/sharpen existing videos, via `qm upscale`. Use when the user wants a
+  sharper/higher-resolution version of an existing photo or video — not for
+  generating new media, and not for restore/beauty/muscle/color_boost (use
+  `quickmagic-edit-image` for those). Triggers: "upscale ảnh lên 4k/8k",
+  "phóng to ảnh nét hơn", "nâng độ phân giải ảnh", "upscale image to 4k",
+  "sharpen this photo", "upscale video", "làm nét video", "video mờ quá làm
+  nét lại", "tăng fps video".
+---
+
+# quickmagic-upscale — Image (2K/4K/8K) + Video Upscale
+
+Wraps `qm upscale <image...>`. Takes **one or more existing images or
+videos** and returns a sharper, higher-resolution (or higher-frame-rate)
+version of each — one credit hold and one job per file. Not for restoring
+damage, beauty retouch, muscle enhancement, or color grading
+(`quickmagic-edit-image` handles those tools), and not for generating new
+media from a text prompt (`quickmagic-generate`).
+
+## Command
+
+```
+qm upscale <file...> [--model <m>] [--resolution <r>] [--video] [--crid <id>]
+```
+
+| Flag | Notes |
+|---|---|
+| `<file...>` **required** (positional, 1+) | URL(s) or local file path(s) — repeatable, one job submitted per file |
+| `--model <m>` | Image: `crisp`\|`standard`\|`seedvr2`\|`ultra`. Video: `standard`\|`pro`\|`seedvr2`\|`fps`. Default `standard` (valid for both) |
+| `--resolution <r>` | Image: `2k`\|`4k`\|`8k`, default `4k`. Video: `720p`\|`1080p`\|`2k`\|`4k`, **no CLI default** — omit it and the server picks `1080p` (do NOT pass `4k` "to be safe", it is the most expensive video tier). **Ignored by image `--model crisp`** and **video `--model fps`** (no resolution option); video `--model pro` does not accept `720p` |
+| `--video` | Force every file in this command to be treated as **video** — only needed when a URL hides its extension (e.g. a signed URL); local paths and URLs ending in `.mp4`/`.mov`/`.webm` are auto-detected, no flag needed |
+| `--crid <id>` | idempotency key; the CLI appends `-0`, `-1`, ... per file so retrying the exact same multi-file command is safe |
+
+Image model choice (ask the user if unclear, or default to `standard`):
+
+| Model | Best for | Notes |
+|---|---|---|
+| `crisp` | quick sharpen, fixed output size | cheapest; does **not** accept `--resolution` |
+| `standard` | general 2K/4K/8K upscale | default |
+| `seedvr2` | best detail retention on faces/text | pricier than `standard` |
+| `ultra` | highest quality, large enlargements | most expensive — confirm cost before running |
+
+Video model choice (ask the user if unclear, or default to `standard`):
+
+| Model | Resolutions | Best for | Notes |
+|---|---|---|---|
+| `standard` | 720p/1080p/2k/4k | general video upscale | default; wait ≈10× the clip length |
+| `pro` | 1080p/2k/4k (no 720p) | highest-fidelity tier | **slowest**, wait ≈25-30× the clip length |
+| `seedvr2` | 720p/1080p/2k/4k | best detail retention | wait ≈6-27× the clip length (higher resolutions are slower) |
+| `fps` | none (ignores `--resolution`) | double the frame rate | **fastest**, wait ≈2-3× the clip length |
+
+Video caps: **300MB / 10 minutes** input. Billing is per second of input,
+rounded up to the next whole second; if that is still below the model
+minimum (`standard`/`seedvr2`: 3s, `pro`/`fps`: 1s) it bills at the minimum
+instead — e.g. a 2s clip on `standard` bills as 3s (30 credits, not 20).
+
+## Before running
+
+1. `qm auth status` → not logged in → `qm auth login`.
+2. `qm models list --type image` does **not** list upscale pricing (it's a
+   separate catalog) — quote credit cost from the table below instead.
+
+## Quote, then confirm
+
+**Image** — state the per-image credit cost **× number of images** and get
+confirmation before running — submitting holds credit immediately, one hold
+per image:
+
+| Model | Credits/image |
+|---|---|
+| `crisp` | 10 |
+| `standard` | 20 |
+| `seedvr2` | 20 |
+| `ultra` | 116 |
+
+**Video** — credits are **per second of input** (not per file); estimate
+from the clip's duration (`ffprobe`, or ask the user): round the seconds up
+to the next whole second, floor that at the model's minimum (`standard`/
+`seedvr2`: 3s, `pro`/`fps`: 1s), then × the rate below — confirm the result
+before running (do not quote a lower number for clips under the minimum):
+
+| Model | 720p | 1080p | 2k | 4k |
+|---|---|---|---|---|
+| `standard` | 10 | 10 | 20 | 39 |
+| `pro` | — (unsupported) | 14 | 28 | 56 |
+| `seedvr2` | 39 | 77 | 96 | 116 |
+| `fps` | 16 (flat, no resolution) | | | |
+
+## Run + track
+
+No `--wait` flag. The CLI prints one job hint per file
+(`→ Theo dõi: quickmagic jobs get ups_5` for images, `vup_5` for videos);
+collect every id from the output, then `qm jobs wait <id> --out ./out` for
+each — single `result_url` per job, `--out` auto-downloads. Video processing
+is slow (see per-model wait multipliers above) — a `processing` status
+(including while the finished file is still being saved) is normal, keep
+waiting, do not resubmit. Report every final URL + total `credits_charged`.
+Result files follow the account plan retention (free plan: 5 days —
+download promptly; paid plans: long-term).
+
+## Errors
+
+`Không đủ credit: ...` → state shortfall + https://quickmagic.vn/pricing.
+Any other failure prints `Lỗi: <message>` and stops the whole command (a
+prior file's job may already be submitted/charged — check with
+`qm jobs get ups_<n>` / `qm jobs get vup_<n>` before retrying that one
+file). Full reference: `quickmagic-account` skill.
+
+## Example
+
+```bash
+qm upscale ./old-photo.jpg --model standard --resolution 4k
+qm upscale ./a.jpg ./b.jpg ./c.jpg --model seedvr2 --resolution 8k
+qm jobs wait ups_5 --out ./out
+
+qm upscale ./clip.mp4 --model standard --resolution 1080p
+qm upscale https://files.quickmagic.cloud/media-tools/clip.mp4 --model fps
+qm jobs wait vup_12 --out ./out
+```

package/src/commands/apps.js

@@ -0,0 +1,76 @@
+// commands/apps.js — Ứng dụng React SSR trên <slug>.quickmagic.app (Apps đợt B): create / list / status / deploy / publish / remove.
+// KHÔNG có `apps db` / `apps secrets` (bề mặt nhạy cảm — chỉ agent qua MCP). repo-access in clone_url ra stdout theo yêu cầu tường minh.
+const api = require('../api');
+
+const SLEEP = (ms) => new Promise((r) => setTimeout(r, ms));
+
+function printApp(a) {
+  console.log(`${a.title || '(chưa tên)'}  [${a.id}]`);
+  console.log(`  URL:      ${a.url || '—'}`);
+  console.log(`  Deploy:   ${a.deploy_status || '—'}${a.last_build ? ` (build #${a.last_build.id} ${a.last_build.status}${a.last_build.error_code ? ' ' + a.last_build.error_code : ''})` : ''}`);
+  console.log(`  Duyệt:    ${a.review_status || '—'} · công khai: ${a.is_public ? 'có' : 'không'} · cover: ${a.thumb_url ? 'có' : 'chưa'} · DB: ${a.has_db ? 'có' : 'không'}`);
+  if (a.has_unbuilt_commits) console.log('  ⚠️ Có commit chưa deploy — chạy: qm apps deploy <app_id>');
+  if (a.last_build && a.last_build.error_text) console.log(`  Lỗi build: ${String(a.last_build.error_text).slice(0, 300)}`);
+}
+
+async function create(options) {
+  const body = { title: options.title, subdomain: options.subdomain, category: options.category, description: options.description };
+  if (options.from) body.from_app_id = options.from;
+  const data = await api.call('POST', '/apps', { body });
+  console.log(`Đã tạo app ${data.id}${data.remixed_from ? ` (remix từ "${data.remixed_from.title}")` : ''}`);
+  printApp(data);
+  console.log('Tiếp: qm apps repo-access <app_id> → git clone → sửa → push → qm apps deploy <app_id>');
+}
+async function list() {
+  const data = await api.call('GET', '/apps');
+  const apps = data.apps || [];
+  if (!apps.length) { console.log('Chưa có app nào. Tạo: qm apps create --title "Tên app"'); return; }
+  const id_w = 36, slug_w = Math.max(4, ...apps.map((a) => String(a.slug || '').length));
+  console.log(`${'APP_ID'.padEnd(id_w)}  ${'SLUG'.padEnd(slug_w)}  DEPLOY     DUYỆT     PUBLIC  TITLE`);
+  for (const a of apps) console.log(`${a.id.padEnd(id_w)}  ${String(a.slug || '').padEnd(slug_w)}  ${String(a.deploy_status || '').padEnd(9)}  ${String(a.review_status || '').padEnd(8)}  ${a.is_public ? 'có ' : 'không'}   ${a.title || ''}`);
+}
+async function status(app_id, options) {
+  const data = await api.call('GET', `/apps/${encodeURIComponent(app_id)}`);
+  if (options && options.json) { console.log(JSON.stringify(data, null, 2)); return; }
+  printApp(data);
+}
+async function repoAccess(app_id) {
+  const data = await api.call('POST', `/apps/${encodeURIComponent(app_id)}/repo-access`, { body: {} });
+  // In clone_url có token TTL 15' — người dùng CLI chủ động xin, KHÔNG log ở nơi khác.
+  console.log(`Quyền push repo (hết hạn ${data.expires_at}):`);
+  console.log(data.clone_url);
+  console.log(`git clone ${data.clone_url} app && cd app`);
+}
+async function deploy(app_id, options) {
+  const data = await api.call('POST', `/apps/${encodeURIComponent(app_id)}/deploy`, { body: {} });
+  console.log(`Đã xếp hàng build #${data.build_id} → ${data.url}`);
+  if (!options || !options.wait) { console.log('Theo dõi: qm apps status <app_id>'); return; }
+  for (let i = 0; i < 60; i++) {
+    await SLEEP(5000);
+    const s = await api.call('GET', `/apps/${encodeURIComponent(app_id)}`);
+    const b = s.last_build;
+    if (b && String(b.id) === String(data.build_id) && ['succeeded', 'failed'].includes(b.status)) {
+      if (b.status === 'succeeded') { console.log(`✅ Deploy xong (${Math.round((b.duration_ms || 0) / 1000)}s): ${s.url}`); return; }
+      console.error(`❌ Build thất bại (${b.error_code || 'lỗi'}): ${String(b.error_text || '').slice(0, 400)}`); process.exit(1);
+    }
+    process.stdout.write(`  … ${b ? b.step || b.status : 'queued'}\r`);
+  }
+  console.error('Hết 5 phút chưa xong — kiểm: qm apps status <app_id>'); process.exit(1);
+}
+async function publish(app_id, options) {
+  try {
+    const data = await api.call('POST', `/apps/${encodeURIComponent(app_id)}/publish`, { body: { is_public: !(options && options.unlist) } });
+    console.log(data.is_public ? `✅ Đã công khai lên feed Ứng dụng: ${data.url}` : 'Đã gỡ khỏi feed (link trực tiếp vẫn hoạt động).');
+  } catch (e) {
+    const m = String(e.message || '');
+    if (/APP_REVIEW_PENDING|chờ duyệt/.test(m)) { console.log('⏳ App đang chờ duyệt nội dung (app đầu tiên của tài khoản được duyệt tay). Link trực tiếp vẫn dùng được.'); return; }
+    throw e;
+  }
+}
+async function remove(app_id, options) {
+  if (!options || !options.yes) { console.error('Xoá VĨNH VIỄN app (Worker + DB + repo, subdomain khoá mãi). Xác nhận bằng --yes.'); process.exit(1); }
+  const data = await api.call('DELETE', `/apps/${encodeURIComponent(app_id)}`);
+  console.log(`Đã xoá app ${data.slug || app_id}.`);
+}
+
+module.exports = { create, list, status, repoAccess, deploy, publish, remove };

package/src/commands/tools.js

@@ -12,7 +12,9 @@ const jobHint = (data) => {
   const id = data.job_id || (Array.isArray(data.job_ids) && data.job_ids[0]);
   if (id) console.log(`\n→ Theo dõi: quickmagic jobs get ${id}`);
 };
-const run = (fn) => (...a) => fn(...a).catch((e) => { console.error('Lỗi:', e.message); process.exit(1); });
+// [code-review-p03.md L8] api.js#call gán e.code = json.code (REST giữ nguyên code cho mục đích này) —
+// bản cũ chỉ in message, script/agent đọc stderr KHÔNG phân biệt được 'feature_disabled' với lỗi khác.
+const run = (fn) => (...a) => fn(...a).catch((e) => { console.error('Lỗi:', e.code ? `[${e.code}] ${e.message}` : e.message); process.exit(1); });
 
 // ── Nhập liệu (không tốn credit) ──
 const scrape = run(async (url) => out(await call('POST', '/scrape', { body: { url } })));
@@ -29,7 +31,39 @@ const product = run(async (o) => jobHint(await call('POST', '/product/images', {
 const fashion = run(async (o) => jobHint(await call('POST', '/fashion/images', { body: { mode: o.mode, outfit_ids: (o.outfit || []).map(Number), kol_kind: o.kolKind, kol_id: o.kolId ? Number(o.kolId) : undefined, model: o.model, client_request_id: o.crid } })));
 
 // ── Ảnh ──
-const edit = run(async (image, o) => jobHint(await call('POST', '/edit', { body: { image: await rmi(image), tool: o.tool, model: o.model, upscale_target: o.upscaleTarget, style: o.style, client_request_id: o.crid } })));
+const edit = run(async (image, o) => jobHint(await call('POST', '/edit', { body: { image: await rmi(image), tool: o.tool, model: o.model, style: o.style, client_request_id: o.crid } })));
+// [260825, plans/260825-1344-upscale-studio-hf-clone P04] 1 lệnh CLI = N file = N job (mỗi file 1
+// job/hold riêng, REST /upscale(-video) chỉ nhận 1 file/call). --crid dùng CHUNG y nguyên cho cả vòng
+// lặp sẽ khiến BE coi file 2+ TRÙNG file 1 (idempotency theo client_request_id) → chỉ file đầu có job
+// thật, các file sau lặng lẽ trả về CÙNG job đó (thiếu file, không lỗi rõ ràng) — hậu tố `-${i}` cho
+// mỗi file 1 khoá riêng, vẫn giữ được idempotency khi retry NGUYÊN LỆNH (cùng --crid, cùng thứ tự file).
+//
+// [260826, plans/260826-1200-upscale-video-hf-clone-byteplus-vcube P03] mở rộng ẢNH → VIDEO cùng lệnh:
+// --video ép mọi file coi là video; không truyền thì tự nhận theo đuôi .mp4/.mov/.webm (KHÔNG .m4v —
+// media.js/get_upload_url không có mime cho đuôi này). data:video/ hoặc data:image/ (file ≤64KB đã
+// inline) tự nhận theo mime, KHÔNG cần đuôi.
+const VIDEO_EXT_RE = /\.(mp4|mov|webm)(\?.*)?$/i;
+function looksLikeVideo(ref) {
+  if (/^data:video\//i.test(ref)) return true;
+  if (/^data:image\//i.test(ref)) return false;
+  if (/^https?:\/\//i.test(ref)) {
+    try { return VIDEO_EXT_RE.test(new URL(ref).pathname); } catch { return false; }
+  }
+  return VIDEO_EXT_RE.test(ref);
+}
+const upscale = run(async (files, o) => {
+  for (const [i, f] of files.entries()) {              // LẶP — không phải files[0]
+    const crid = o.crid ? `${o.crid}-${i}` : undefined;
+    const is_video = !!o.video || looksLikeVideo(f);
+    // [code-review-p03.md H3] --resolution KHÔNG còn default ở commander (index.js). Ảnh: giữ default
+    // '4k' CŨ (P04, chỉ áp khi user không truyền). Video: KHÔNG tự thêm default — để trống thì server
+    // (createMediaJobs) tự chọn default_resolution 1080p, tránh CLI âm thầm gửi bậc giá đắt nhất.
+    const res = is_video
+      ? await call('POST', '/upscale-video', { body: { video: await rmi(f), model: o.model, resolution: o.resolution, client_request_id: crid } })
+      : await call('POST', '/upscale', { body: { image: await rmi(f), model: o.model, resolution: o.resolution || '4k', client_request_id: crid } });
+    jobHint(res);                                       // in job_id từng file
+  }
+});
 const tryon = run(async (o) => jobHint(await call('POST', '/tryon', { body: { type: o.type, model: o.model, model_image: await rmi(o.model_image), garment_image: await rmi(o.garment), upper_image: await rmi(o.upper), lower_image: await rmi(o.lower), background_image: await rmi(o.background), prompt: o.prompt, client_request_id: o.crid } })));
 
 // ── Video nặng / audio ──
@@ -43,4 +77,4 @@ const cutout = run(async (o) => jobHint(await call('POST', '/cutout', { body: {
 const hookPresets = run(async () => out(await call('GET', '/hook/presets')));
 const hookVideo = run(async (o) => jobHint(await call('POST', '/hook/videos', { body: { preset_id: o.preset, character_url: await rmi(o.character), product_url: await rmi(o.product), aspect: o.aspect, speech_lang: o.speechLang, custom_cta: o.cta, location_url: o.location, accessory_url: o.accessory, style: o.style, format: o.format, resolution: o.resolution, client_request_id: o.crid } })));
 
-module.exports = { scrape, importSocial, assets, analyze, marketingModes, marketingVideo, product, fashion, edit, tryon, stt, subtitle, split, motion, cutout, hookPresets, hookVideo };
+module.exports = { scrape, importSocial, assets, analyze, marketingModes, marketingVideo, product, fashion, edit, upscale, tryon, stt, subtitle, split, motion, cutout, hookPresets, hookVideo };

package/src/commands/voice.js

@@ -66,6 +66,8 @@ const voicesList = run(async (o) => {
   const data = await call('GET', `/voices${buildQuery({ model: o.model, language: o.language, search: o.search, limit: o.limit })}`);
   const pricing = data.pricing || {}; // [review C4] BE lỗi/shape cũ → không crash, in được phần còn lại
   printPricing(pricing);
+  // qimi_3.5: server builds this hint from its own preset list — print it verbatim instead of hard-coding keys here.
+  if (data.style_hint) console.log(data.style_hint);
   if (pricing.billing === 'per_char') {
     if (data.clone_price != null) console.log(`Giá clone giọng riêng: ${data.clone_price} credit`);
     // [review C2] false có 2 nghĩa: (a) đã dùng suất, (b) chưa có gói trả phí active (BE trả first_free_upsell=true).
@@ -93,7 +95,12 @@ const voicesList = run(async (o) => {
     }
     if (systems.length) {
       console.log('Giọng hệ thống:');
-      printTable(['VOICE', 'NAME', 'NAME_EN', 'GENDER', 'LANGUAGE'], systems.map((v) => [v.voice, v.name, v.name_en, v.gender, v.language]));
+      // qimi_3.5 system voices (the qimi_3 catalog) have no English name — drop the empty column.
+      const has_en = systems.some((v) => v.name_en);
+      printTable(
+        has_en ? ['VOICE', 'NAME', 'NAME_EN', 'GENDER', 'LANGUAGE'] : ['VOICE', 'NAME', 'GENDER', 'LANGUAGE'],
+        systems.map((v) => (has_en ? [v.voice, v.name, v.name_en, v.gender, v.language] : [v.voice, v.name, v.gender, v.language])),
+      );
     }
   }
   console.log(`\nNgôn ngữ: ${(data.languages || []).join(' · ')}`);

package/src/index.js

@@ -11,6 +11,7 @@ const credits = require('./commands/credits');
 const tools = require('./commands/tools');
 const voice = require('./commands/voice');
 const music = require('./commands/music');
+const apps = require('./commands/apps');
 
 const collect = (v, acc) => { acc.push(v); return acc; };
 
@@ -130,9 +131,22 @@ program.command('fashion').description('Tạo ảnh thời trang AI')
   .action(tools.fashion);
 
 // ── Ảnh ────────────────────────────────────────────────────────────────────────
-program.command('edit <image>').description('Sửa ảnh: restore/upscale/beauty/muscle/color_boost')
+program.command('edit <image>').description('Sửa ảnh: restore/beauty/muscle/color_boost (upscale → dùng lệnh `qm upscale`)')
   .requiredOption('--tool <t>').option('--model <m>', 'qimi_2.5|qimi_3', 'qimi_3')
-  .option('--upscale-target <t>', '2k|4k').option('--style <s...>').option('--crid <id>').action(tools.edit);
+  .option('--style <s...>').option('--crid <id>').action(tools.edit);
+// [260826, plans/260826-1200-upscale-video-hf-clone-byteplus-vcube P03] mở rộng ẢNH → VIDEO cùng lệnh
+// (giữ nguyên tên arg <image...> — đã pin cứng trong test BE mcp-upscale-wiring.test.js). Video tự
+// nhận theo đuôi .mp4/.mov/.webm (KHÔNG .m4v — media.js/get_upload_url không có mime cho đuôi này),
+// hoặc ép bằng --video khi URL không lộ đuôi (vd link ký chữ ký).
+program.command('upscale <image...>').description('Upscale ảnh (crisp|standard|seedvr2|ultra) hoặc video (standard|pro|seedvr2|fps) — 1 lệnh nhiều file = mỗi file 1 job. File video: .mp4/.mov/.webm, tự nhận theo đuôi hoặc ép bằng --video')
+  .option('--model <m>', 'Ảnh: crisp|standard|seedvr2|ultra — Video: standard|pro|seedvr2|fps', 'standard')
+  // [code-review-p03.md H3] KHÔNG đặt default ở đây — default '4k' hợp lý cho ẢNH (giữ nguyên hành vi
+  // cũ P04) nhưng SAI cho VIDEO (server default là 1080p, rẻ hơn 4k standard 3.9×). Default lệch theo
+  // media_type xử lý TRONG tools.upscale (ảnh mới rơi về '4k' khi không truyền; video để trống, server tự chọn).
+  .option('--resolution <r>', 'Ảnh: 2k|4k|8k, mặc định 4k (bỏ qua crisp) — Video: 720p|1080p|2k|4k, mặc định 1080p do server chọn khi không truyền (bỏ qua fps, pro không nhận 720p)')
+  .option('--video', 'Ép MỌI file trong lệnh này là VIDEO (mặc định tự nhận theo đuôi .mp4/.mov/.webm)')
+  .option('--crid <id>', 'client_request_id (tự thêm hậu tố theo từng file)')
+  .action(tools.upscale);
 program.command('tryon').description('Thử đồ ảo (virtual try-on)')
   .requiredOption('--model-image <img>', 'Ảnh người mẫu (URL/base64)')
   .option('--type <t>', 'full|upper', 'full').option('--model <m>', 'qimi_1.5|qimi_2.5|qimi_3', 'qimi_3')
@@ -150,28 +164,46 @@ program.command('motion <video_url>').description('Áp chuyển động video v
   .requiredOption('--image <url...>', 'Ảnh áp motion (1-20)')
   .option('--model <m>').option('--mode <m>', 'standard|professional').option('--prompt <p>').option('--crid <id>').action(tools.motion);
 
+// ── Media-tools mở rộng [260902] — cùng kho model Spaces "Bàn Sáng Tạo" ─────
+program.command('sfx <prompt>').description('Tạo hiệu ứng âm thanh từ mô tả (whoosh/nổ/mưa/bước chân…)')
+  .option('--model <m>', 'sfx-lite (mặc định) | sfx-pro').option('--duration <s>', 'Giây: lite 3/5/10/15/30, pro 3/5/10/15 (mặc định 5)').option('--crid <id>').action(tools.sfx);
+program.command('remove-bg <image>').description('Tách nền ảnh → PNG trong suốt')
+  .option('--crid <id>').action(tools.removeBg);
+const t3d = program.command('3d').description('Model 3D (.glb): tạo từ ảnh/mô tả + hoạt hình');
+t3d.command('create').description('Tạo model 3D từ ảnh hoặc mô tả')
+  .option('--image <i>', 'Ảnh tham chiếu (file/URL)').option('--prompt <p>', 'Mô tả model')
+  .option('--model <m>', 'tripo-v3 (mặc định) | tripo-v2-5').option('--texture <t>', 'standard | textureless').option('--crid <id>').action(tools.gen3d);
+t3d.command('animate <model_url>').description('Hoạt hình model 3D đã tạo (rig + preset chuyển động)')
+  .option('--preset <p>', 'Tên preset (vd dance_01, wave_goodbye_01)').option('--crid <id>').action(tools.animate3d);
+program.command('talking-photo').description('Ảnh chân dung + audio → video nói chuyện (khớp môi)')
+  .requiredOption('--image <i>', 'Ảnh chân dung (file/URL)').requiredOption('--audio <url>', 'Audio giọng nói (vd kết quả qm tts)')
+  .option('--model <m>', 'talk-fast (mặc định) | talk-standard').option('--resolution <r>', '480p | 720p (talk-standard)').option('--prompt <p>', 'Gợi ý biểu cảm').option('--crid <id>').action(tools.talkingPhoto);
+program.command('extend-video <video_url>').description('Kéo dài video — sinh tiếp N giây sau khung cuối')
+  .requiredOption('--duration <s>', 'Giây đoạn mới: wan 3-10, seedance 4-15')
+  .option('--model <m>', 'vext-wan-2-5 (mặc định) | vext-seedance-2-0').option('--resolution <r>', '480p/720p/1080p (+4k seedance)').option('--prompt <p>', 'Điều xảy ra tiếp theo').option('--crid <id>').action(tools.extendVideo);
+
 // ── TTS / Voices ─────────────────────────────────────────────────────────────
 program
   .command('tts')
-  .description('Chuyển văn bản → giọng nói (5 engine qimi_1.5/2.5/3/5/5.5)')
+  .description('Chuyển văn bản → giọng nói (6 engine qimi_1.5/2.5/3/3.5/5/5.5)')
   .option('--text <t>', 'Văn bản cần đọc')
   .option('--file <path>', 'Đọc văn bản từ file local (thay --text)')
-  .option('--model <m>', 'qimi_1.5|qimi_2.5|qimi_3|qimi_5|qimi_5.5', 'qimi_3')
+  .option('--model <m>', 'qimi_1.5|qimi_2.5|qimi_3|qimi_3.5|qimi_5|qimi_5.5 (qimi_3.5: giọng qimi_3, giá cố định mỗi lần — xem giá ở qm voices list --model qimi_3.5, tối đa 30.000 ký tự)', 'qimi_3')
   .requiredOption('--voice <v>', 'Tên giọng — xem cột VOICE của qm voices list')
   .option('--language <l>', 'Ngôn ngữ — phân biệt giọng trùng tên (xem qm voices list)')
-  .option('--speed <n>', 'Tốc độ đọc 0.5-2.0 (mặc định 1) — CHỈ qimi_5/qimi_5.5')
-  .option('--style <s>', 'Phong cách đọc — nhãn từ cột STYLES của qm voices list')
+  .option('--speed <n>', 'Tốc độ đọc 0.5-2.0 (mặc định 1) — CHỈ qimi_5/qimi_5.5 (qimi_3.5: chỉnh tốc độ bằng --style)')
+  .option('--style <s>', 'Kiểu đọc. qimi_1.5/2.5/3: nhãn cột STYLES của qm voices list. qimi_3.5: tối đa 1 tốc độ (fast|default|slow) + 1 cảm xúc (cheerful|sad|storytelling|emotional) nối bằng "+", vd "slow+storytelling"; hoặc tự mô tả tiếng Việt "custom:<mô tả ≤200 ký tự>" — danh sách mới nhất: qm voices list --model qimi_3.5')
   .option('--title <t>', 'Tiêu đề job')
   .option('--crid <id>', 'client_request_id')
   .option('--wait', 'Chờ tới khi job hoàn tất')
-  .option('--out <dir>', 'Thư mục lưu file mp3 (dùng kèm --wait)')
+  .option('--out <dir>', 'Thư mục lưu file audio mp3/wav (dùng kèm --wait)')
   .action(voice.tts);
 
 const voices_cmd = program.command('voices').description('Giọng đọc: catalog + giọng clone của bạn');
 voices_cmd
   .command('list')
-  .description('Liệt kê giọng theo model')
-  .requiredOption('--model <m>', 'qimi_1.5|qimi_2.5|qimi_3|qimi_5|qimi_5.5')
+  .description('Liệt kê giọng theo model (+ giá, và gợi ý kiểu đọc với qimi_3.5)')
+  .requiredOption('--model <m>', 'qimi_1.5|qimi_2.5|qimi_3|qimi_3.5|qimi_5|qimi_5.5')
   .option('--language <l>', 'Lọc theo ngôn ngữ')
   .option('--search <s>', 'Lọc theo tên (không phân biệt hoa/thường)')
   .option('--limit <n>', 'Số lượng tối đa (mặc định 50, trần 100)')
@@ -256,6 +288,20 @@ hook_cmd
   .option('--crid <id>', 'client_request_id')
   .action(tools.hookVideo);
 
+// ── apps (Ứng dụng React SSR trên <slug>.quickmagic.app — Apps đợt B) ─────────
+const apps_cmd = program.command('apps').description('Ứng dụng web đầy đủ (React SSR, subdomain riêng, Sign in with Quick Magic)');
+apps_cmd.command('create').description('Tạo app mới (repo từ template) — cần duyệt nếu gọi từ agent')
+  .requiredOption('--title <t>', 'Tên app').option('--subdomain <s>', 'Subdomain mong muốn (tự thêm hậu tố 4 ký tự)')
+  .option('--category <c>', 'Danh mục').option('--description <d>', 'Mô tả 1 câu')
+  .option('--from <app_id>', 'Remix: chép mã nguồn app công khai đã duyệt (không chép secrets/DB/cover)')
+  .action(apps.create);
+apps_cmd.command('list').description('Liệt kê app của tôi').action(apps.list);
+apps_cmd.command('status <app_id>').description('Trạng thái deploy/duyệt/build gần nhất').option('--json', 'In JSON').action(apps.status);
+apps_cmd.command('repo-access <app_id>').description('Lấy URL git clone có token 15 phút (in ra stdout)').action(apps.repoAccess);
+apps_cmd.command('deploy <app_id>').description('Build + deploy nhánh main').option('--wait', 'Chờ tới khi xong (≤5 phút)').action(apps.deploy);
+apps_cmd.command('publish <app_id>').description('Đưa lên feed Ứng dụng (cần deployed + cover; tự kiểm duyệt nội dung)').option('--unlist', 'Gỡ khỏi feed').action(apps.publish);
+apps_cmd.command('remove <app_id>').description('Xoá vĩnh viễn app').option('--yes', 'Xác nhận').action(apps.remove);
+
 program.parseAsync(process.argv).catch((e) => {
   console.error('Lỗi:', e.message);
   process.exit(1);