focalapi-cli 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.6.0 - 2026-08-26
+
+- Retired `gen omni-video` with a local redirect to `gen video -m gemini-omni-flash-preview`: the gateway rejects the Interactions endpoint for this model in every shape (video matrix evidence 2026-08-26). All four capabilities (t2v/first-frame/reference/edit) ride the video facade.
+- Added task-parameter flags to `gen video`, mapped to the task DTO's top-level fields with local enum validation: `--omni-reference-task-type` (seedance 2.5 edit/extend semantics were unreachable — auto-inference conflicts with the default duration), `--voice`/`--avatar` (HeyGen, enums now published by the platform), `--operation` (Bria), `--enhance-model` (HitPaw), and `--upscaler-model` (Topaz).
+- Added local constraint tables for the August video wave (wan2.7 ×4, pixverse-v5, kling-v3-omni, luma-ray-3-2, MiniMax-H3, HeyGen ×2, happyhorse ×4, topaz/hitpaw video, beeble, bria, veo 3.1 ×3): duration tiers and resolutions are validated locally, and source-length families (heygen, topaz/hitpaw video, beeble, bria, happyhorse video-edit) reject `--seconds` up front instead of round-tripping a guaranteed 400.
+
+## 0.5.1 - 2026-08-26
+
+- Added `@file` support to `--style-references` and `--moodboards`: the JSON array can now be read from a file instead of inline argv. Windows `cmd` mangles embedded double quotes in JSON arguments (matrix-run evidence 2026-08-25), and the file source sidesteps shell quoting entirely.
+
 ## 0.5.0 - 2026-08-25
 
 - Fixed `krea-2-medium/-turbo/large` reference-image validation: the local table said 0 while the platform contract accepts up to 10 reference images (each maps to a Krea style reference), so every `gen image --image` edit was rejected locally without reaching the server (2026-08-25 live audit P01).

package/dist/cli.js

@@ -176,7 +176,7 @@ function displayWidth(s) {
 }
 
 // src/lib/version.ts
-var VERSION = true ? "0.5.0" : "0.0.0-dev";
+var VERSION = true ? "0.6.0" : "0.0.0-dev";
 
 // src/commands/auth.ts
 import { createInterface } from "readline/promises";
@@ -1321,6 +1321,42 @@ var VIDEO_CONSTRAINTS = {
     maxReferenceImages: 2,
     supportsGenerateAudio: true
   },
+  "wan2.7-t2v": { resolutions: ["720p", "1080p"], minSeconds: 2, maxSeconds: 15 },
+  "wan2.7-i2v": { resolutions: ["720p", "1080p"], minSeconds: 2, maxSeconds: 15 },
+  "wan2.7-r2v": { resolutions: ["720p", "1080p"], minSeconds: 2, maxSeconds: 15 },
+  "wan2.7-videoedit": { resolutions: ["720p", "1080p"], minSeconds: 2, maxSeconds: 10 },
+  "pixverse-v5": { resolutions: ["360p", "540p", "720p", "1080p"], minSeconds: 5, maxSeconds: 8, allowedSeconds: [5, 8] },
+  "kling-v3-omni": { resolutions: ["720p", "1080p", "4k"], minSeconds: 3, maxSeconds: 15 },
+  "luma-ray-3-2": { resolutions: ["540p", "720p", "1080p"], minSeconds: 5, maxSeconds: 10, allowedSeconds: [5, 10] },
+  "MiniMax-H3": { resolutions: ["768p", "2k"], minSeconds: 5, maxSeconds: 15 },
+  "heygen-talking-photo": { resolutions: ["720p", "1080p"], noDuration: true },
+  "heygen-avatar": { resolutions: ["720p", "1080p"], noDuration: true },
+  "happyhorse-1.1-t2v": { resolutions: ["720p", "1080p"], minSeconds: 3, maxSeconds: 15 },
+  "happyhorse-1.1-i2v": { resolutions: ["720p", "1080p"], minSeconds: 3, maxSeconds: 15 },
+  "happyhorse-1.1-r2v": { resolutions: ["720p", "1080p"], minSeconds: 3, maxSeconds: 15 },
+  "happyhorse-1.0-video-edit": { resolutions: ["720p", "1080p"], noDuration: true },
+  "topaz-video-enhance": { resolutions: ["1080p", "2160p"], noDuration: true },
+  "hitpaw-video-enhance": { resolutions: ["original", "720p", "1080p", "2k/qhd", "4k/uhd", "8k"], noDuration: true },
+  "beeble-switchx-video": { resolutions: ["720p", "1080p"], noDuration: true },
+  "bria-video-edit": { noDuration: true },
+  "veo-3.1-generate-preview": {
+    resolutions: ["720p", "1080p"],
+    minSeconds: 4,
+    maxSeconds: 8,
+    allowedSeconds: [4, 6, 8]
+  },
+  "veo-3.1-fast-generate-preview": {
+    resolutions: ["720p", "1080p"],
+    minSeconds: 4,
+    maxSeconds: 8,
+    allowedSeconds: [4, 6, 8]
+  },
+  "veo-3.1-lite-generate-preview": {
+    resolutions: ["720p", "1080p"],
+    minSeconds: 4,
+    maxSeconds: 8,
+    allowedSeconds: [4, 6, 8]
+  },
   "flux-3": {
     resolutions: ["hd", "fhd"],
     ratios: FLUX_VIDEO_RATIOS,
@@ -1523,6 +1559,9 @@ function validateGeminiImageGeneration(model, input) {
 function validateVideoGeneration(model, input) {
   const constraint = VIDEO_CONSTRAINTS[model.trim()];
   if (!constraint) return;
+  if (constraint.noDuration && input.seconds !== void 0) {
+    throw new ApiError("invalid_request", `${model} does not accept a duration; the output length follows the source media`);
+  }
   if (constraint.maxPromptRunes !== void 0 && input.promptRunes !== void 0) {
     const referenceCount = input.imageCount ?? input.firstFrameCount ?? 0;
     if (input.promptRunes + 500 * referenceCount > constraint.maxPromptRunes) {
@@ -1547,13 +1586,13 @@ function validateVideoGeneration(model, input) {
   if (input.watermark !== void 0 && constraint.supportsWatermark === false) {
     throw new ApiError("invalid_request", `${model} does not support watermark`);
   }
-  if (input.seconds !== void 0 && (input.seconds < constraint.minSeconds || input.seconds > constraint.maxSeconds)) {
+  if (input.seconds !== void 0 && constraint.minSeconds !== void 0 && constraint.maxSeconds !== void 0 && (input.seconds < constraint.minSeconds || input.seconds > constraint.maxSeconds)) {
     throw new ApiError("invalid_request", `${model} seconds must be ${constraint.minSeconds}-${constraint.maxSeconds} (received: ${input.seconds})`);
   }
   if (input.seconds !== void 0 && constraint.allowedSeconds && !constraint.allowedSeconds.includes(input.seconds)) {
     throw new ApiError("invalid_request", `${model} seconds must be one of ${constraint.allowedSeconds.join(", ")} (received: ${input.seconds})`);
   }
-  if (input.resolution && !constraint.resolutions.includes(input.resolution.toLowerCase())) {
+  if (input.resolution && constraint.resolutions && !constraint.resolutions.includes(input.resolution.toLowerCase())) {
     throw new ApiError("invalid_request", `${model} resolution must be one of ${constraint.resolutions.join(", ")} (received: ${input.resolution})`);
   }
   if (input.resolution && (input.imageCount ?? 0) > 0 && constraint.referenceResolutions && !constraint.referenceResolutions.includes(input.resolution.toLowerCase())) {
@@ -1943,6 +1982,15 @@ function parseJsonArray(raw, option) {
     throw new ApiError("invalid_request", `--${option} must be a JSON array`);
   }
 }
+async function readJsonArrayArgument(raw, option) {
+  if (!raw.startsWith("@")) return parseJsonArray(raw, option);
+  try {
+    return parseJsonArray((await readFile(normalizeHomePath(raw.slice(1)), "utf8")).trim(), option);
+  } catch (error) {
+    if (error instanceof ApiError) throw error;
+    throw new ApiError("invalid_request", `--${option} @file \u65E0\u6CD5\u8BFB\u53D6\uFF1A${raw.slice(1, 120)}`);
+  }
+}
 var MAX_CONTENT_FILE_BYTES = 64 * 1024 * 1024;
 async function readContentArgument(raw) {
   if (raw === "-") {
@@ -2046,24 +2094,6 @@ function geminiImagePart(source) {
   }
   return { fileData: { fileUri: source } };
 }
-function geminiOmniImageInput(source) {
-  const dataUri = /^data:([^;,]+);base64,([a-z0-9+/=\r\n]+)$/i.exec(source.trim());
-  if (!dataUri) {
-    throw new ApiError("invalid_request", "--image for Gemini Omni must be a base64 data URI");
-  }
-  const [, mimeType = "", data = ""] = dataUri;
-  return { type: "image", mime_type: mimeType, data: data.replace(/[\r\n]/g, "") };
-}
-function extractGeminiOmniVideo(response) {
-  for (const step of response.steps ?? []) {
-    for (const content of step.content ?? []) {
-      if (content.type === "video" && content.data) {
-        return { data: content.data, mimeType: content.mime_type };
-      }
-    }
-  }
-  return void 0;
-}
 function extractGeminiImageItems(response) {
   return (response.candidates ?? []).flatMap(
     (candidate) => (candidate.content?.parts ?? []).flatMap(
@@ -2079,8 +2109,8 @@ function registerGen(program) {
     const model = opts.model ?? (await resolveCreativeModel(auth, "image")).model.id;
     if (!opts.model && !g.json) info(`\u5DF2\u81EA\u52A8\u9009\u62E9\u56FE\u50CF\u6A21\u578B\uFF1A${model}`);
     const n = clampInt(opts.n, 1, MAX_IMAGE_N, "n");
-    const styleReferences = opts.styleReferences ? parseJsonArray(opts.styleReferences, "style-references") : void 0;
-    const moodboards = opts.moodboards ? parseJsonArray(opts.moodboards, "moodboards") : void 0;
+    const styleReferences = opts.styleReferences ? await readJsonArrayArgument(opts.styleReferences, "style-references") : void 0;
+    const moodboards = opts.moodboards ? await readJsonArrayArgument(opts.moodboards, "moodboards") : void 0;
     const referenceImages = await resolveMediaInputs(opts.image ?? []);
     const maskImage = (await resolveMediaInputs(opts.mask ? [opts.mask] : []))[0];
     validateImageGeneration(model, {
@@ -2232,49 +2262,10 @@ function registerGen(program) {
       for (const file of files) info(`\u2713 ${file}`);
     }
   });
-  gen.command("omni-video").description("\u4F7F\u7528 Gemini Omni Flash \u539F\u751F Interactions API \u751F\u6210\u6216\u7F16\u8F91\u89C6\u9891").argument("<prompt...>", "\u63D0\u793A\u8BCD").option("--image <data-uri...>", "\u56FE\u751F\u89C6\u9891\u53C2\u8003\u56FE\uFF1B\u4EC5\u652F\u6301 base64 data URI\uFF0C\u53EF\u591A\u4E2A").option("--previous-interaction-id <id>", "\u4E0A\u4E00\u6B21\u4EA4\u4E92 ID\uFF0C\u7528\u4E8E\u8FDE\u7EED\u89C6\u9891\u7F16\u8F91").option("--aspect-ratio <ratio>", "\u753B\u9762\u6BD4\u4F8B\uFF1A16:9 \u6216 9:16").option("--task <task>", "\u89C6\u9891\u4EFB\u52A1\uFF1Atext_to_video\u3001image_to_video\u3001reference_to_video \u6216 edit").option("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55", DEFAULT_OUT_DIR).action(async (promptParts, opts, cmd) => {
-    const g = cmd.optsWithGlobals();
-    const auth = resolveAuth(g);
-    if (opts.aspectRatio && !["16:9", "9:16"].includes(opts.aspectRatio)) {
-      throw new ApiError("invalid_request", "--aspect-ratio must be 16:9 or 9:16");
-    }
-    if (opts.task && !["text_to_video", "image_to_video", "reference_to_video", "edit"].includes(opts.task)) {
-      throw new ApiError("invalid_request", "--task must be text_to_video, image_to_video, reference_to_video, or edit");
-    }
-    const prompt = promptParts.join(" ");
-    const imageInputs = (opts.image ?? []).map(geminiOmniImageInput);
-    const input = imageInputs.length === 0 ? prompt : [...imageInputs, { type: "text", text: prompt }];
-    const res = await withProgress("\u6B63\u5728\u751F\u6210 Gemini Omni \u89C6\u9891", () => request({
-      baseUrl: auth.baseUrl,
-      path: "/v1beta/interactions",
-      apiKey: auth.apiKey,
-      body: {
-        model: "gemini-omni-flash-preview",
-        input,
-        ...opts.previousInteractionId ? { previous_interaction_id: opts.previousInteractionId } : {},
-        ...opts.aspectRatio ? { response_format: { type: "video", aspect_ratio: opts.aspectRatio } } : {},
-        ...opts.task ? { generation_config: { video_config: { task: opts.task } } } : {}
-      },
-      timeoutMs: 6e5
-    }));
-    const video = extractGeminiOmniVideo(res);
-    if (!video) {
-      throw new ApiError("bad_response", "Gemini Omni \u54CD\u5E94\u4E2D\u672A\u627E\u5230\u89C6\u9891\u6570\u636E", { body: res });
-    }
-    const dir = resolve2(opts.out);
-    await mkdir2(dir, { recursive: true });
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-    const extension = video.mimeType?.includes("webm") ? ".webm" : ".mp4";
-    const file = join3(dir, `gemini-omni-${timestamp}${extension}`);
-    await writeFile(file, Buffer.from(video.data, "base64"));
-    if (g.json) {
-      printJson({ interaction_id: res.id, file });
-    } else {
-      info(`\u2713 ${file}`);
-      if (res.id) info(`\u4EA4\u4E92 ID\uFF1A${res.id}`);
-    }
+  gen.command("omni-video").description("\u5DF2\u4E0B\u7EBF\uFF1AGemini Omni Flash \u5168\u90E8\u80FD\u529B\u6539\u8D70 gen video \u95E8\u9762").allowUnknownOption().action(async () => {
+    throw new ApiError("invalid_request", "gen omni-video \u5DF2\u4E0B\u7EBF\uFF1Agemini-omni-flash-preview \u7684\u6587\u751F\u89C6\u9891/\u9996\u5E27/\u53C2\u8003/\u7F16\u8F91\u80FD\u529B\u5168\u90E8\u6539\u8D70 `focalapi gen video -m gemini-omni-flash-preview`\uFF08\u652F\u6301 --first-frame/--image/--content\uFF09");
   });
-  gen.command("video").description("\u751F\u6210\u89C6\u9891\uFF08\u7701\u7565 --model \u65F6\u81EA\u52A8\u9009\u62E9\u5F53\u524D\u53EF\u7528\u9ED8\u8BA4\u6A21\u578B\uFF09").argument("<prompt...>", "\u63D0\u793A\u8BCD").option("-m, --model <model>", "\u89C6\u9891\u6A21\u578B ID\uFF1B\u7701\u7565\u65F6\u7531 focalapi \u81EA\u52A8\u9009\u62E9").option("--seconds <n>", "\u65F6\u957F\u79D2\u6570\uFF1B--duration \u4E3A\u540C\u4E49\u522B\u540D\u3002\u7CBE\u786E\u8303\u56F4\u8FD0\u884C focalapi models get <model> \u67E5\u770B", (v) => Number.parseInt(v, 10)).option("--duration <n>", "\u65F6\u957F\u79D2\u6570\uFF08--seconds \u7684\u522B\u540D\uFF0C\u4E0E API \u5951\u7EA6\u5B57\u6BB5\u540C\u540D\uFF09", (v) => Number.parseInt(v, 10)).option("--size <size>", "\u5206\u8FA8\u7387\uFF0C\u5982 1280x720").option("--resolution <resolution>", "\u539F\u751F\u8F93\u51FA\u5206\u8FA8\u7387\uFF0C\u5982 480p\u3001720p\u30011080p\u30014k").option("--ratio <ratio>", "\u539F\u751F\u5BBD\u9AD8\u6BD4\uFF0C\u5982 16:9\u30019:16\u3001adaptive").option("--aspect-ratio <ratio>", "\u6A21\u578B\u539F\u751F\u753B\u9762\u6BD4\u4F8B\uFF0C\u5982 16:9\u30019:16\u3001auto").option("--seed <n>", "\u6A21\u578B\u968F\u673A\u79CD\u5B50\uFF08\u975E\u8D1F\u6574\u6570\uFF09", (v) => Number.parseInt(v, 10)).option("--fps <n>", "\u8F93\u51FA\u5E27\u7387\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09", (v) => Number.parseInt(v, 10)).option("--safety-tolerance <n>", "\u5B89\u5168\u5BB9\u5FCD\u5EA6\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09", (v) => Number.parseInt(v, 10)).option("--image <url...>", "\u53C2\u8003\u56FE URL \u6216\u672C\u5730\u8DEF\u5F84\uFF08@C:/path/x.jpg\uFF09\uFF0CGrok \u89C6\u9891\u4E3A reference-to-video \u6A21\u5F0F").option("--first-frame <url>", "\u56FE\u751F\u89C6\u9891\u9996\u5E27\u56FE URL\uFF08image-to-video \u6A21\u5F0F\uFF1B\u4E0E --image \u4E92\u65A5\uFF09").option("--generate-audio <boolean>", "\u662F\u5426\u751F\u6210\u97F3\u9891\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "generate-audio")).option("--watermark <boolean>", "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "watermark")).option("--service-tier <tier>", "\u670D\u52A1\u5C42\u7EA7\uFF08Seedance 2.0 \u9ED8\u8BA4 default\uFF09").option("--priority <n>", "\u4EFB\u52A1\u4F18\u5148\u7EA7\uFF08\u4EC5 Seedance 2.0 \u7CFB\u5217\uFF09", (v) => Number.parseInt(v, 10)).option("--callback-url <url>", "\u4EFB\u52A1\u5B8C\u6210\u56DE\u8C03 URL").option("--return-last-frame <boolean>", "\u662F\u5426\u8FD4\u56DE\u6700\u540E\u4E00\u5E27\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "return-last-frame")).option("--execution-expires-after <seconds>", "\u4EFB\u52A1\u8FC7\u671F\u79D2\u6570\uFF083600\u2013259200\uFF09", (v) => Number.parseInt(v, 10)).option("--safety-identifier <identifier>", "Seedance \u5B89\u5168\u6807\u8BC6\u7B26\uFF081\u201364 \u4E2A\u53EF\u6253\u5370 ASCII \u5B57\u7B26\uFF09").option("--no-wait", "\u63D0\u4EA4\u540E\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u7B49\u5F85\u5B8C\u6210").option("--idempotency-key <key>", "\u5E42\u7B49\u952E\uFF088\u2013128 \u4E2A\u53EF\u6253\u5370 ASCII \u5B57\u7B26\uFF09\u3002\u540C\u4E00 key \u7684\u91CD\u590D\u63D0\u4EA4\u62FF\u56DE\u539F\u4EFB\u52A1\u800C\u4E0D\u91CD\u590D\u8BA1\u8D39\uFF1B\u7701\u7565\u65F6\u81EA\u52A8\u751F\u6210\u3002\u91CD\u8BD5\u4E0D\u786E\u5B9A\u7684\u63D0\u4EA4\u65F6\u52A1\u5FC5\u590D\u7528\u539F key").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\u6BEB\u79D2", (v) => Number.parseInt(v, 10), 5e3).option("--timeout <minutes>", "\u6700\u957F\u7B49\u5F85\u5206\u949F", (v) => Number.parseInt(v, 10), 30).option("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55", DEFAULT_OUT_DIR).option("--content <json>", "Ark content JSON \u6570\u7EC4\uFF1B\u652F\u6301\u5185\u8054 JSON\u3001@\u6587\u4EF6\u8DEF\u5F84\uFF08\u591A\u56FE base64 \u5FC5\u987B\u8D70\u6587\u4EF6\uFF09\u6216 - \uFF08stdin\uFF09\uFF1B\u8986\u76D6 prompt/image \u95E8\u9762\u5B57\u6BB5").action(
+  gen.command("video").description("\u751F\u6210\u89C6\u9891\uFF08\u7701\u7565 --model \u65F6\u81EA\u52A8\u9009\u62E9\u5F53\u524D\u53EF\u7528\u9ED8\u8BA4\u6A21\u578B\uFF09").argument("<prompt...>", "\u63D0\u793A\u8BCD").option("-m, --model <model>", "\u89C6\u9891\u6A21\u578B ID\uFF1B\u7701\u7565\u65F6\u7531 focalapi \u81EA\u52A8\u9009\u62E9").option("--seconds <n>", "\u65F6\u957F\u79D2\u6570\uFF1B--duration \u4E3A\u540C\u4E49\u522B\u540D\u3002\u7CBE\u786E\u8303\u56F4\u8FD0\u884C focalapi models get <model> \u67E5\u770B", (v) => Number.parseInt(v, 10)).option("--duration <n>", "\u65F6\u957F\u79D2\u6570\uFF08--seconds \u7684\u522B\u540D\uFF0C\u4E0E API \u5951\u7EA6\u5B57\u6BB5\u540C\u540D\uFF09", (v) => Number.parseInt(v, 10)).option("--size <size>", "\u5206\u8FA8\u7387\uFF0C\u5982 1280x720").option("--resolution <resolution>", "\u539F\u751F\u8F93\u51FA\u5206\u8FA8\u7387\uFF0C\u5982 480p\u3001720p\u30011080p\u30014k").option("--ratio <ratio>", "\u539F\u751F\u5BBD\u9AD8\u6BD4\uFF0C\u5982 16:9\u30019:16\u3001adaptive").option("--aspect-ratio <ratio>", "\u6A21\u578B\u539F\u751F\u753B\u9762\u6BD4\u4F8B\uFF0C\u5982 16:9\u30019:16\u3001auto").option("--seed <n>", "\u6A21\u578B\u968F\u673A\u79CD\u5B50\uFF08\u975E\u8D1F\u6574\u6570\uFF09", (v) => Number.parseInt(v, 10)).option("--fps <n>", "\u8F93\u51FA\u5E27\u7387\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09", (v) => Number.parseInt(v, 10)).option("--safety-tolerance <n>", "\u5B89\u5168\u5BB9\u5FCD\u5EA6\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09", (v) => Number.parseInt(v, 10)).option("--image <url...>", "\u53C2\u8003\u56FE URL \u6216\u672C\u5730\u8DEF\u5F84\uFF08@C:/path/x.jpg\uFF09\uFF0CGrok \u89C6\u9891\u4E3A reference-to-video \u6A21\u5F0F").option("--first-frame <url>", "\u56FE\u751F\u89C6\u9891\u9996\u5E27\u56FE URL\uFF08image-to-video \u6A21\u5F0F\uFF1B\u4E0E --image \u4E92\u65A5\uFF09").option("--generate-audio <boolean>", "\u662F\u5426\u751F\u6210\u97F3\u9891\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "generate-audio")).option("--watermark <boolean>", "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "watermark")).option("--service-tier <tier>", "\u670D\u52A1\u5C42\u7EA7\uFF08Seedance 2.0 \u9ED8\u8BA4 default\uFF09").option("--priority <n>", "\u4EFB\u52A1\u4F18\u5148\u7EA7\uFF08\u4EC5 Seedance 2.0 \u7CFB\u5217\uFF09", (v) => Number.parseInt(v, 10)).option("--callback-url <url>", "\u4EFB\u52A1\u5B8C\u6210\u56DE\u8C03 URL").option("--return-last-frame <boolean>", "\u662F\u5426\u8FD4\u56DE\u6700\u540E\u4E00\u5E27\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "return-last-frame")).option("--execution-expires-after <seconds>", "\u4EFB\u52A1\u8FC7\u671F\u79D2\u6570\uFF083600\u2013259200\uFF09", (v) => Number.parseInt(v, 10)).option("--safety-identifier <identifier>", "Seedance \u5B89\u5168\u6807\u8BC6\u7B26\uFF081\u201364 \u4E2A\u53EF\u6253\u5370 ASCII \u5B57\u7B26\uFF09").option("--omni-reference-task-type <type>", "Seedance 2.5 \u591A\u6A21\u6001\u4EFB\u52A1\u7C7B\u578B\uFF1Aauto\u3001reference\u3001edit \u6216 extend\uFF08\u7F16\u8F91/\u5EF6\u957F\u53C2\u8003\u89C6\u9891\u65F6\u5FC5\u586B\uFF0Cauto \u4F1A\u4E0E\u9ED8\u8BA4\u65F6\u957F\u51B2\u7A81\uFF09").option("--voice <label>", "HeyGen \u8BED\u97F3\u6807\u7B7E\uFF08talking-photo \u5267\u672C\u5FC5\u586B\uFF1B\u5408\u6CD5\u503C\u89C1 models get heygen-talking-photo \u7684 voice \u679A\u4E3E\uFF09").option("--avatar <label>", "HeyGen Avatar \u5F62\u8C61\u6807\u7B7E\uFF08heygen-avatar \u5FC5\u586B\uFF1B\u5408\u6CD5\u503C\u89C1 models get heygen-avatar \u7684 avatar \u679A\u4E3E\uFF09").option("--operation <op>", "Bria \u89C6\u9891\u64CD\u4F5C\uFF1Aremove_background\u3001green_screen \u6216 replace_background").option("--enhance-model <id>", "HitPaw \u89C6\u9891\u589E\u5F3A\u6A21\u578B\uFF08\u5982 general_restore_2x\uFF1B\u5B8C\u6574\u679A\u4E3E\u89C1 models get hitpaw-video-enhance\uFF09").option("--upscaler-model <family>", "Topaz \u89C6\u9891\u653E\u5927\u6A21\u578B\uFF1Astarlight_fast\u3001starlight_creative\u3001starlight_precise_25 \u6216 astra_2").option("--no-wait", "\u63D0\u4EA4\u540E\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u7B49\u5F85\u5B8C\u6210").option("--idempotency-key <key>", "\u5E42\u7B49\u952E\uFF088\u2013128 \u4E2A\u53EF\u6253\u5370 ASCII \u5B57\u7B26\uFF09\u3002\u540C\u4E00 key \u7684\u91CD\u590D\u63D0\u4EA4\u62FF\u56DE\u539F\u4EFB\u52A1\u800C\u4E0D\u91CD\u590D\u8BA1\u8D39\uFF1B\u7701\u7565\u65F6\u81EA\u52A8\u751F\u6210\u3002\u91CD\u8BD5\u4E0D\u786E\u5B9A\u7684\u63D0\u4EA4\u65F6\u52A1\u5FC5\u590D\u7528\u539F key").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\u6BEB\u79D2", (v) => Number.parseInt(v, 10), 5e3).option("--timeout <minutes>", "\u6700\u957F\u7B49\u5F85\u5206\u949F", (v) => Number.parseInt(v, 10), 30).option("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55", DEFAULT_OUT_DIR).option("--content <json>", "Ark content JSON \u6570\u7EC4\uFF1B\u652F\u6301\u5185\u8054 JSON\u3001@\u6587\u4EF6\u8DEF\u5F84\uFF08\u591A\u56FE base64 \u5FC5\u987B\u8D70\u6587\u4EF6\uFF09\u6216 - \uFF08stdin\uFF09\uFF1B\u8986\u76D6 prompt/image \u95E8\u9762\u5B57\u6BB5").action(
     async (promptParts, opts, cmd) => {
       const g = cmd.optsWithGlobals();
       const auth = resolveAuth(g);
@@ -2309,6 +2300,28 @@ function registerGen(program) {
       if (opts.returnLastFrame !== void 0) metadata.return_last_frame = opts.returnLastFrame;
       if (opts.executionExpiresAfter !== void 0) metadata.execution_expires_after = opts.executionExpiresAfter;
       if (opts.safetyIdentifier) metadata.safety_identifier = opts.safetyIdentifier;
+      if (opts.omniReferenceTaskType) {
+        const taskType = opts.omniReferenceTaskType.toLowerCase();
+        if (!["auto", "reference", "edit", "extend"].includes(taskType)) {
+          throw new ApiError("invalid_request", "--omni-reference-task-type must be auto, reference, edit, or extend");
+        }
+        body.omni_reference_task_type = taskType;
+      }
+      if (opts.voice) body.voice = opts.voice;
+      if (opts.avatar) body.avatar = opts.avatar;
+      if (opts.operation) {
+        if (!["remove_background", "green_screen", "replace_background"].includes(opts.operation)) {
+          throw new ApiError("invalid_request", "--operation must be remove_background, green_screen, or replace_background");
+        }
+        body.operation = opts.operation;
+      }
+      if (opts.enhanceModel) body.enhance_model = opts.enhanceModel;
+      if (opts.upscalerModel) {
+        if (!["starlight_fast", "starlight_creative", "starlight_precise_25", "astra_2"].includes(opts.upscalerModel)) {
+          throw new ApiError("invalid_request", "--upscaler-model must be starlight_fast, starlight_creative, starlight_precise_25, or astra_2");
+        }
+        body.upscaler_model = opts.upscalerModel;
+      }
       if (opts.content) metadata.content = parseJsonArray(await readContentArgument(opts.content), "content");
       validateVideoGeneration(model, {
         promptRunes: [...promptParts.join(" ")].length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "focalapi-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "让任意 AI Agent 直接调用 focalapi 创作模型的命令行工具",
   "type": "module",
   "bin": {