quickmagic-cli 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickmagic-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Quick Magic CLI — generate AI images/videos, product photoshoots, virtual try-on, hook ad videos, subtitles and more via the Quick Magic REST API, with browser-based OAuth PKCE login (no API keys to manage). Ships with 8 Claude Agent Skills and an MCP server integration.",
   "bin": {
     "quickmagic": "src/index.js",

package/src/commands/elements.js

@@ -0,0 +1,42 @@
+// commands/elements.js — thư viện element tái dùng: xem `@tag` để trỏ trong prompt video, và tạo mới.
+// BE dịch `@tag` trong prompt thành "Image N (mô tả)" lúc gửi provider → giữ nhân vật/sản phẩm
+// nhất quán qua nhiều cảnh. Nhớ đưa ảnh element vào `--image` kèm `--mode reference`.
+const api = require('../api');
+const { resolveMediaInput } = require('../media');
+
+async function list(options) {
+  const limit = (options && options.limit) || 50;
+  const data = await api.call('GET', `/elements?limit=${encodeURIComponent(limit)}`);
+  const items = (data && data.elements) || [];
+  if (!items.length) {
+    console.log('Chưa có element nào. Tạo bằng: qm elements create --name "Áo dài đỏ" --image ./ao.jpg --desc "..."');
+    return;
+  }
+
+  const tag_w = Math.max(3, ...items.map((e) => `@${e.tag}`.length));
+  const name_w = Math.max(4, ...items.map((e) => (e.name || '').length));
+  console.log(`${'TAG'.padEnd(tag_w)}  ${'TÊN'.padEnd(name_w)}  MÔ TẢ`);
+  console.log('─'.repeat(tag_w + name_w + 30));
+  for (const e of items) {
+    const desc = (e.description || '').replace(/\s+/g, ' ');
+    const short = desc.length > 60 ? `${desc.slice(0, 57)}...` : desc;
+    console.log(`${`@${e.tag}`.padEnd(tag_w)}  ${(e.name || '').padEnd(name_w)}  ${short}`);
+  }
+  console.log(`\nDùng: qm generate video --prompt "cô gái mặc @${items[0].tag} đi dạo" --image <url-element> --mode reference --model seedance-2-0`);
+}
+
+async function create(options) {
+  // File local → tự upload presigned lên host Quick Magic (server chỉ nhận URL của mình).
+  const media_url = await resolveMediaInput(options.image);
+  const body = { name: options.name, media_url };
+  if (options.desc) body.description = options.desc;
+  if (options.category) body.category = options.category;
+  if (options.type) body.media_type = options.type;
+
+  const data = await api.call('POST', '/elements', { body });
+  console.log(`Đã tạo element: @${data.tag} (${data.name})`);
+  if (data.description) console.log(`Mô tả gửi kèm model: ${data.description}`);
+  console.log(`Dùng trong prompt: "@${data.tag}"`);
+}
+
+module.exports = { list, create };

package/src/commands/generate.js

@@ -34,6 +34,12 @@ async function video(options) {
   // --video-ref (v2v 260723): file local tự upload presigned → URL host QM; server probe duration
   // + validate (chỉ seedance-2-0/-fast, max 15s, không mix ảnh, giá hạng with-video).
   if (options.videoRef) body.video_ref_url = await resolveMediaInput(options.videoRef);
+  // [260726] 4 tham số nâng cao — server đã nhận sẵn, CLI chỉ chưa mở.
+  // --no-audio: commander set options.audio = false; mặc định undefined (giữ default của model).
+  if (Number.isInteger(options.seed)) body.seed = options.seed;
+  if (options.negative) body.negative_prompt = options.negative;
+  if (options.cameraFixed) body.camera_fixed = true;
+  if (options.audio === false) body.audio = false;
 
   const data = await api.call('POST', '/videos', { body });
   const job_id = data.job_id;

package/src/index.js

@@ -4,6 +4,7 @@ const { program } = require('commander');
 
 const auth = require('./commands/auth');
 const generate = require('./commands/generate');
+const elements = require('./commands/elements');
 const jobs = require('./commands/jobs');
 const models = require('./commands/models');
 const credits = require('./commands/credits');
@@ -51,10 +52,32 @@ gen_cmd
   .option('--image <i...>', 'Ảnh đầu vào (URL hoặc file local, lặp nhiều lần — max theo model+mode, xem qm models)')
   .option('--mode <m>', 'Chế độ ảnh: reference (nhiều ảnh tham chiếu) | frames (khung đầu/cuối, max 2). Seedance 2.x KHÔNG nhận ảnh người thật ở MỌI chế độ (xem qm models --type video)')
   .option('--video-ref <v>', 'Video tham chiếu (URL hoặc file local, max 15s/100MB) — CHỈ model supports_video_ref (seedance-2-0/-fast). Giá = rate with-video × (giây output + giây video); không dùng chung với --image')
+  .option('--seed <n>', 'Seed cố định — cùng seed + cùng prompt cho kết quả LẶP LẠI được (giữ nhất quán khi render nhiều cảnh)', parseInt)
+  .option('--negative <p>', 'Mô tả thứ KHÔNG muốn xuất hiện (watermark, chữ, tay thừa…) — model nào không hỗ trợ thì bỏ qua')
+  .option('--camera-fixed', 'Khoá máy quay đứng yên (không pan/zoom) — hợp cảnh xoay sản phẩm')
+  .option('--no-audio', 'Tắt tiếng (không đổi giá)')
   .option('--wait', 'Chờ tới khi job hoàn tất')
   .option('--out <dir>', 'Thư mục lưu kết quả (dùng kèm --wait)')
   .action(generate.video);
 
+// ── elements ─────────────────────────────────────────────────────────────────
+// [260726] Thư viện element tái dùng: `@tag` trong prompt → BE dịch thành "Image N (mô tả)".
+const elements_cmd = program.command('elements').description('Thư viện element tái dùng (@tag trong prompt)');
+elements_cmd
+  .command('list')
+  .description('Liệt kê element + tag để trỏ trong prompt')
+  .option('--limit <n>', 'Số lượng tối đa (mặc định 50)')
+  .action(elements.list);
+elements_cmd
+  .command('create')
+  .description('Lưu 1 ảnh thành element tái dùng')
+  .requiredOption('--name <n>', 'Tên element, vd "Áo dài đỏ" (tag tự sinh từ tên)')
+  .requiredOption('--image <i>', 'Ảnh (URL hoặc file local — tự upload)')
+  .option('--desc <d>', 'Mô tả chi tiết — CHÍNH là thứ được chèn kèm ảnh vào prompt, viết càng rõ càng giữ được nhân vật')
+  .option('--category <c>', 'character | location | prop | product | style | other')
+  .option('--type <t>', 'image (mặc định) | video')
+  .action(elements.create);
+
 // ── jobs ─────────────────────────────────────────────────────────────────────
 const jobs_cmd = program.command('jobs').description('Theo dõi job');
 jobs_cmd.command('get <id>').description('Xem chi tiết job (JSON)').action(jobs.get);