focalapi-cli 0.2.0 → 0.2.2

package/dist/cli.js

@@ -8,11 +8,11 @@ var ApiError = class extends Error {
   code;
   status;
   hint;
-  /** 上游返回的稳定错误代码或类型；不包含密钥等敏感请求信息。 */
+  /** Stable upstream error code or type, without sensitive request data such as keys. */
   upstreamCode;
-  /** 可用于向服务方关联日志的请求 ID。 */
+  /** Request ID that the service operator can use to correlate logs. */
   requestId;
-  /** 上游原始响应体（已截断），仅调试用途，打印前需脱敏。 */
+  /** Truncated raw upstream response for debugging only; redact it before printing. */
   body;
   constructor(code, message, opts) {
     super(message);
@@ -155,7 +155,7 @@ function displayWidth(s) {
 }
 
 // src/lib/version.ts
-var VERSION = true ? "0.2.0" : "0.0.0-dev";
+var VERSION = true ? "0.2.2" : "0.0.0-dev";
 
 // src/commands/auth.ts
 import { createInterface } from "readline/promises";
@@ -471,15 +471,22 @@ var RECOMMENDED_MODELS = {
     "seedream-5-0-260128",
     "gpt-image-2",
     "gemini-3.1-flash-image",
-    "grok-imagine-image-quality",
+    "grok-imagine-image-2.0",
+    "kling-v3",
+    "qwen-image-3.0-pro",
+    "krea-2-large",
     "seedream-4-5-251128"
   ],
   video: [
     "dreamina-seedance-2-5-260628",
-    "veo-3.1-generate-preview",
+    "kling-3.0",
+    "viduq3-pro",
+    "gemini-omni-flash-preview",
     "grok-imagine-video-1.5",
-    "dreamina-seedance-2-0-260128",
-    "veo-3.1-fast-generate-preview"
+    "ltx-2-5-fast",
+    "flux-3",
+    "MiniMax-H3",
+    "dreamina-seedance-2-0-260128"
   ]
 };
 function parseCreativeCapability(value) {
@@ -906,6 +913,24 @@ var GROK_IMAGE_ASPECT_RATIOS = [
   "1:3",
   "3:1"
 ];
+var GROK_IMAGE_20_ASPECT_RATIOS = [
+  "auto",
+  "1:1",
+  "2:3",
+  "3:2",
+  "3:4",
+  "4:3",
+  "9:16",
+  "16:9",
+  "9:19.5",
+  "19.5:9",
+  "9:20",
+  "20:9",
+  "1:2",
+  "2:1"
+];
+var KLING_IMAGE_ASPECT_RATIOS = ["16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3", "21:9"];
+var KREA_IMAGE_ASPECT_RATIOS = ["1:1", "4:3", "3:2", "16:9", "2.35:1", "4:5", "2:3", "9:16"];
 var IMAGE_CONSTRAINTS = {
   "gpt-image-2": {
     defaultSize: "1024x1024",
@@ -968,52 +993,103 @@ var IMAGE_CONSTRAINTS = {
     optimizePromptModes: SEEDREAM_OPTIMIZE_PROMPT_MODES
   },
   "grok-imagine-image-quality": {
-    defaultSize: "1024x1024",
     maxN: 10,
     maxReferenceImages: 3,
     aspectRatios: GROK_IMAGE_ASPECT_RATIOS,
     resolutions: ["1k", "2k"],
-    supportsSeed: true
+    supportsSeed: true,
+    maxSeed: 2147483647
   },
   "grok-imagine-image": {
-    defaultSize: "1024x1024",
     maxN: 10,
     maxReferenceImages: 3,
     aspectRatios: GROK_IMAGE_ASPECT_RATIOS,
     resolutions: ["1k", "2k"],
-    supportsSeed: true
+    supportsSeed: true,
+    maxSeed: 2147483647
+  },
+  "grok-imagine-image-2.0": {
+    maxN: 10,
+    maxReferenceImages: 3,
+    aspectRatios: GROK_IMAGE_20_ASPECT_RATIOS,
+    resolutions: ["1k", "2k"],
+    qualities: ["low", "medium"],
+    supportsSeed: true,
+    maxSeed: 2147483647
+  },
+  "kling-v3": {
+    maxN: 9,
+    maxReferenceImages: 1,
+    aspectRatios: KLING_IMAGE_ASPECT_RATIOS,
+    supportsNegativePrompt: true
+  },
+  "krea-2-medium": {
+    maxN: 1,
+    maxReferenceImages: 0,
+    aspectRatios: KREA_IMAGE_ASPECT_RATIOS,
+    resolutions: ["1k"],
+    supportsSeed: true,
+    maxSeed: 2147483647,
+    creativityModes: ["raw", "low", "medium", "high"],
+    maxStyleReferences: 10,
+    maxMoodboards: 1
+  },
+  "krea-2-medium-turbo": {
+    maxN: 1,
+    maxReferenceImages: 0,
+    aspectRatios: KREA_IMAGE_ASPECT_RATIOS,
+    resolutions: ["1k"],
+    supportsSeed: true,
+    maxSeed: 2147483647,
+    creativityModes: ["raw", "low", "medium", "high"],
+    maxStyleReferences: 10,
+    maxMoodboards: 1
+  },
+  "krea-2-large": {
+    maxN: 1,
+    maxReferenceImages: 0,
+    aspectRatios: KREA_IMAGE_ASPECT_RATIOS,
+    resolutions: ["1k"],
+    supportsSeed: true,
+    maxSeed: 2147483647,
+    creativityModes: ["raw", "low", "medium", "high"],
+    maxStyleReferences: 10,
+    maxMoodboards: 1
+  },
+  "qwen-image-3.0": {
+    defaultSize: "1024x1024",
+    maxN: 6,
+    maxReferenceImages: 3,
+    minMegapixels: 0.262144,
+    maxMegapixels: 4.194304,
+    maxAspectRatio: 8,
+    supportsSeed: true,
+    maxSeed: 2147483647,
+    supportsNegativePrompt: true,
+    supportsPromptExtend: true,
+    supportsWatermark: true
+  },
+  "qwen-image-3.0-pro": {
+    defaultSize: "1024x1024",
+    maxN: 6,
+    maxReferenceImages: 3,
+    minMegapixels: 0.262144,
+    maxMegapixels: 4.194304,
+    maxAspectRatio: 8,
+    supportsSeed: true,
+    maxSeed: 2147483647,
+    supportsNegativePrompt: true,
+    supportsPromptExtend: true,
+    supportsWatermark: true
   }
 };
 var SEEDANCE_RATIOS = ["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9"];
 var GROK_VIDEO_ASPECT_RATIOS = ["auto", "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16"];
+var KLING_VIDEO_ASPECT_RATIOS = ["16:9", "9:16", "1:1"];
+var VIDU_VIDEO_ASPECT_RATIOS = ["16:9", "9:16", "3:4", "4:3", "1:1"];
+var MINIMAX_VIDEO_RATIOS = ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"];
+var FLUX_VIDEO_RATIOS = ["auto", "21:9", "2:1", "16:9", "4:3", "1:1", "3:4", "9:16"];
 var VIDEO_CONSTRAINTS = {
-  "veo-3.1-generate-preview": {
-    resolutions: ["720p", "1080p", "4k"],
-    ratios: ["16:9", "9:16"],
-    minSeconds: 4,
-    maxSeconds: 8,
-    allowedSeconds: [4, 6, 8],
-    requiredSecondsByResolution: { "1080p": 8, "4k": 8 },
-    supportsSeed: true
-  },
-  "veo-3.1-fast-generate-preview": {
-    resolutions: ["720p", "1080p", "4k"],
-    ratios: ["16:9", "9:16"],
-    minSeconds: 4,
-    maxSeconds: 8,
-    allowedSeconds: [4, 6, 8],
-    requiredSecondsByResolution: { "1080p": 8, "4k": 8 },
-    supportsSeed: true
-  },
-  "veo-3.1-lite-generate-preview": {
-    resolutions: ["720p", "1080p"],
-    ratios: ["16:9", "9:16"],
-    minSeconds: 4,
-    maxSeconds: 8,
-    allowedSeconds: [4, 6, 8],
-    requiredSecondsByResolution: { "1080p": 8 },
-    supportsSeed: true
-  },
   "dreamina-seedance-2-0-260128": {
     resolutions: ["480p", "720p", "1080p", "4k"],
     ratios: SEEDANCE_RATIOS,
@@ -1041,19 +1117,80 @@ var VIDEO_CONSTRAINTS = {
     minSeconds: 4,
     maxSeconds: 30
   },
+  "gemini-omni-flash-preview": {
+    resolutions: [],
+    ratios: ["16:9", "9:16"],
+    minSeconds: 3,
+    maxSeconds: 10
+  },
   "grok-imagine-video": {
     resolutions: ["480p", "720p", "1080p"],
     aspectRatios: GROK_VIDEO_ASPECT_RATIOS,
     minSeconds: 1,
     maxSeconds: 15,
-    supportsSeed: true
+    supportsSeed: true,
+    maxSeed: 2147483647
   },
   "grok-imagine-video-1.5": {
     resolutions: ["480p", "720p", "1080p"],
     aspectRatios: GROK_VIDEO_ASPECT_RATIOS,
     minSeconds: 1,
     maxSeconds: 15,
-    supportsSeed: true
+    supportsSeed: true,
+    maxSeed: 2147483647
+  },
+  "kling-3.0": {
+    resolutions: ["720p", "1080p", "4k"],
+    aspectRatios: KLING_VIDEO_ASPECT_RATIOS,
+    minSeconds: 3,
+    maxSeconds: 15
+  },
+  "viduq3-pro": {
+    resolutions: ["720p", "1080p"],
+    aspectRatios: VIDU_VIDEO_ASPECT_RATIOS,
+    minSeconds: 1,
+    maxSeconds: 16,
+    supportsSeed: true,
+    maxSeed: 2147483647
+  },
+  "viduq3-turbo": {
+    resolutions: ["720p", "1080p"],
+    aspectRatios: VIDU_VIDEO_ASPECT_RATIOS,
+    minSeconds: 1,
+    maxSeconds: 16,
+    supportsSeed: true,
+    maxSeed: 2147483647
+  },
+  "MiniMax-H3": {
+    resolutions: ["768p", "2k"],
+    ratios: MINIMAX_VIDEO_RATIOS,
+    minSeconds: 5,
+    maxSeconds: 15
+  },
+  "ltx-2-5-fast": {
+    resolutions: ["1280x720", "720x1280", "1920x1080", "1080x1920", "2560x1440", "1440x2560", "3840x2160", "2160x3840"],
+    minSeconds: 2,
+    maxSeconds: 20,
+    allowedSeconds: [2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18, 20],
+    supportsSeed: true,
+    maxSeed: 4294967295,
+    allowedFps: [24, 25, 48, 50]
+  },
+  "ltx-2-5-pro": {
+    resolutions: ["1280x720", "720x1280", "1920x1080", "1080x1920"],
+    minSeconds: 2,
+    maxSeconds: 10,
+    allowedSeconds: [2, 3, 4, 5, 6, 8, 10],
+    supportsSeed: true,
+    maxSeed: 4294967295,
+    allowedFps: [24, 25, 50]
+  },
+  "flux-3": {
+    resolutions: ["hd", "fhd"],
+    ratios: FLUX_VIDEO_RATIOS,
+    minSeconds: 5,
+    maxSeconds: 20,
+    safetyTolerance: { minimum: 0, maximum: 4 }
   }
 };
 var COMMON_GEMINI_RATIOS = ["auto", "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"];
@@ -1113,17 +1250,40 @@ function validateImageGeneration(model, input) {
   validateOptionalChoice(model, "resolution", input.resolution, constraint.resolutions);
   validateOptionalChoice(model, "output_format", input.outputFormat, constraint.outputFormats);
   validateOptionalChoice(model, "optimize_prompt", input.optimizePrompt, constraint.optimizePromptModes);
+  validateOptionalChoice(model, "creativity", input.creativity, constraint.creativityModes);
+  if (input.negativePrompt !== void 0 && !constraint.supportsNegativePrompt) {
+    throw new ApiError("invalid_request", `${model} does not support negative_prompt`);
+  }
+  if (input.negativePrompt !== void 0 && model === "kling-v3" && (input.imageCount ?? 0) > 0) {
+    throw new ApiError("invalid_request", "kling-v3 negative_prompt cannot be combined with an image input");
+  }
+  if (input.promptExtend !== void 0 && !constraint.supportsPromptExtend) {
+    throw new ApiError("invalid_request", `${model} does not support prompt_extend`);
+  }
+  if (input.styleReferenceCount !== void 0 && (constraint.maxStyleReferences === void 0 || input.styleReferenceCount > constraint.maxStyleReferences)) {
+    throw new ApiError("invalid_request", `${model} supports at most ${constraint.maxStyleReferences ?? 0} image style references`);
+  }
+  if (input.moodboardCount !== void 0 && (constraint.maxMoodboards === void 0 || input.moodboardCount > constraint.maxMoodboards)) {
+    throw new ApiError("invalid_request", `${model} supports at most ${constraint.maxMoodboards ?? 0} moodboards`);
+  }
   if (input.seed !== void 0) {
     if (!constraint.supportsSeed) {
       throw new ApiError("invalid_request", `${model} does not support seed`);
     }
-    if (!Number.isInteger(input.seed) || input.seed < 0) {
-      throw new ApiError("invalid_request", "seed must be a non-negative integer");
+    if (!Number.isInteger(input.seed) || input.seed < 0 || constraint.maxSeed !== void 0 && input.seed > constraint.maxSeed) {
+      const maximum = constraint.maxSeed === void 0 ? "" : ` no greater than ${constraint.maxSeed}`;
+      throw new ApiError("invalid_request", `seed must be a non-negative integer${maximum}`);
     }
   }
   if (input.watermark !== void 0 && !constraint.supportsWatermark) {
     throw new ApiError("invalid_request", `${model} does not support watermark`);
   }
+  if (!constraint.defaultSize) {
+    if (input.size) {
+      throw new ApiError("invalid_request", `${model} does not support size; use its aspect_ratio or resolution parameter`);
+    }
+    return;
+  }
   const suppliedSize = input.size ?? constraint.defaultSize;
   if (constraint.sizeTiers?.includes(suppliedSize.toLowerCase())) return;
   if (constraint.sizeTiers && !/^\d+x\d+$/i.test(suppliedSize)) {
@@ -1210,10 +1370,18 @@ function validateVideoGeneration(model, input) {
     if (!constraint.supportsSeed) {
       throw new ApiError("invalid_request", `${model} does not support seed`);
     }
-    if (!Number.isInteger(input.seed) || input.seed < 0) {
-      throw new ApiError("invalid_request", "seed must be a non-negative integer");
+    if (!Number.isInteger(input.seed) || input.seed < 0 || constraint.maxSeed !== void 0 && input.seed > constraint.maxSeed) {
+      const maximum = constraint.maxSeed === void 0 ? "" : ` no greater than ${constraint.maxSeed}`;
+      throw new ApiError("invalid_request", `seed must be a non-negative integer${maximum}`);
     }
   }
+  if (input.fps !== void 0 && (!constraint.allowedFps || !constraint.allowedFps.includes(input.fps))) {
+    throw new ApiError("invalid_request", `${model} fps must be one of ${constraint.allowedFps?.join(", ") ?? "none"} (received: ${input.fps})`);
+  }
+  if (input.safetyTolerance !== void 0 && (!constraint.safetyTolerance || !Number.isInteger(input.safetyTolerance) || input.safetyTolerance < constraint.safetyTolerance.minimum || input.safetyTolerance > constraint.safetyTolerance.maximum)) {
+    const range = constraint.safetyTolerance ? `${constraint.safetyTolerance.minimum}-${constraint.safetyTolerance.maximum}` : "unsupported";
+    throw new ApiError("invalid_request", `${model} safety_tolerance must be ${range} (received: ${input.safetyTolerance})`);
+  }
   if (input.priority !== void 0 && !constraint.supportsPriority) {
     throw new ApiError("invalid_request", `${model} does not support priority`);
   }
@@ -1470,12 +1638,14 @@ function extractGeminiImageItems(response) {
 }
 function registerGen(program) {
   const gen = program.command("gen").description("\u56FE\u50CF / \u89C6\u9891\u751F\u6210");
-  gen.command("image").description("\u751F\u6210\u56FE\u50CF\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>", "\u56FE\u50CF\u6A21\u578B ID\uFF1B\u7701\u7565\u65F6\u7531 focalapi \u81EA\u52A8\u9009\u62E9").option("--size <size>", "\u5C3A\u5BF8\uFF0C\u5982 1024x1024").option("--aspect-ratio <ratio>", "\u539F\u751F\u753B\u9762\u6BD4\u4F8B\uFF08\u4EC5 Grok \u56FE\u50CF\u6A21\u578B\uFF09\uFF0C\u5982 16:9").option("--resolution <resolution>", "\u539F\u751F\u8F93\u51FA\u6863\u4F4D\uFF08\u4EC5 Grok \u56FE\u50CF\u6A21\u578B\uFF09\uFF0C\u5982 1k\u30012k").option("--seed <n>", "\u968F\u673A\u79CD\u5B50\uFF08\u4EC5 Grok \u56FE\u50CF\u6A21\u578B\uFF0C\u975E\u8D1F\u6574\u6570\uFF09", (v) => Number.parseInt(v, 10)).option("--quality <quality>", "\u56FE\u50CF\u8D28\u91CF\u6863\u4F4D\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09").option("--background <background>", "\u80CC\u666F\u6A21\u5F0F\uFF08\u4EC5 gpt-image-2 \u652F\u6301 auto/opaque\uFF09").option("--watermark <boolean>", "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\uFF08\u4EC5 Seedream\uFF0Ctrue \u6216 false\uFF09", (v) => parseBooleanOption(v, "watermark")).option("--output-format <format>", "\u8F93\u51FA\u683C\u5F0F\uFF08\u4EC5 Seedream\uFF1Apng \u6216 jpeg\uFF09").option("--optimize-prompt <mode>", "\u63D0\u793A\u8BCD\u4F18\u5316\uFF08\u4EC5 Seedream\uFF1Aauto\u3001enabled \u6216 disabled\uFF09").option("--image <url...>", "\u53C2\u8003\u56FE\u6216\u7F16\u8F91\u56FE URL\uFF0C\u53EF\u591A\u4E2A").option("--mask <url>", "\u7F16\u8F91 mask URL\uFF08gpt-image-2 \u9700\u8981\u5355\u5F20\u53C2\u8003\u56FE\uFF09").option("--response-format <format>", "\u56FE\u50CF\u54CD\u5E94\u683C\u5F0F\uFF1Aurl \u6216 b64_json").option("--n <count>", "\u5F20\u6570\uFF081\u2013128\uFF09", (v) => Number.parseInt(v, 10), 1).option("--no-wait", "\u63D0\u4EA4\u540E\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u7B49\u5F85\u56FE\u50CF\u751F\u6210\u5B8C\u6210").option("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55", DEFAULT_OUT_DIR).action(async (promptParts, opts, cmd) => {
+  gen.command("image").description("\u751F\u6210\u56FE\u50CF\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>", "\u56FE\u50CF\u6A21\u578B ID\uFF1B\u7701\u7565\u65F6\u7531 focalapi \u81EA\u52A8\u9009\u62E9").option("--size <size>", "\u5C3A\u5BF8\uFF0C\u5982 1024x1024").option("--aspect-ratio <ratio>", "\u6A21\u578B\u539F\u751F\u753B\u9762\u6BD4\u4F8B\uFF0C\u5982 16:9").option("--resolution <resolution>", "\u6A21\u578B\u539F\u751F\u8F93\u51FA\u6863\u4F4D\uFF0C\u5982 1k\u30012k").option("--seed <n>", "\u6A21\u578B\u968F\u673A\u79CD\u5B50\uFF08\u975E\u8D1F\u6574\u6570\uFF09", (v) => Number.parseInt(v, 10)).option("--quality <quality>", "\u56FE\u50CF\u8D28\u91CF\u6863\u4F4D\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09").option("--background <background>", "\u80CC\u666F\u6A21\u5F0F\uFF08\u4EC5 gpt-image-2 \u652F\u6301 auto/opaque\uFF09").option("--negative-prompt <text>", "\u8D1F\u9762\u63D0\u793A\u8BCD\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09").option("--creativity <level>", "\u63D0\u793A\u8BCD\u6269\u5C55\u5F3A\u5EA6\uFF0C\u5982 raw\u3001low\u3001medium\u3001high").option("--prompt-extend <boolean>", "\u662F\u5426\u6269\u5C55\u63D0\u793A\u8BCD\uFF08\u53EA\u63A5\u53D7 true \u6216 false\uFF09", (v) => parseBooleanOption(v, "prompt-extend")).option("--style-references <json>", "Krea image_style_references JSON \u6570\u7EC4").option("--moodboards <json>", "Krea moodboards JSON \u6570\u7EC4").option("--watermark <boolean>", "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\uFF08\u4EC5\u652F\u6301\u8BE5\u53C2\u6570\u7684\u6A21\u578B\u751F\u6548\uFF09", (v) => parseBooleanOption(v, "watermark")).option("--output-format <format>", "\u8F93\u51FA\u683C\u5F0F\uFF08\u4EC5 Seedream\uFF1Apng \u6216 jpeg\uFF09").option("--optimize-prompt <mode>", "\u63D0\u793A\u8BCD\u4F18\u5316\uFF08\u4EC5 Seedream\uFF1Aauto\u3001enabled \u6216 disabled\uFF09").option("--image <url...>", "\u53C2\u8003\u56FE\u6216\u7F16\u8F91\u56FE URL\uFF0C\u53EF\u591A\u4E2A").option("--mask <url>", "\u7F16\u8F91 mask URL\uFF08gpt-image-2 \u9700\u8981\u5355\u5F20\u53C2\u8003\u56FE\uFF09").option("--response-format <format>", "\u56FE\u50CF\u54CD\u5E94\u683C\u5F0F\uFF1Aurl \u6216 b64_json").option("--n <count>", "\u5F20\u6570\uFF081\u2013128\uFF09", (v) => Number.parseInt(v, 10), 1).option("--no-wait", "\u63D0\u4EA4\u540E\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u7B49\u5F85\u56FE\u50CF\u751F\u6210\u5B8C\u6210").option("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55", DEFAULT_OUT_DIR).action(async (promptParts, opts, cmd) => {
     const g = cmd.optsWithGlobals();
     const auth = resolveAuth(g);
     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;
     validateImageGeneration(model, {
       n,
       size: opts.size,
@@ -1487,6 +1657,11 @@ function registerGen(program) {
       watermark: opts.watermark,
       outputFormat: opts.outputFormat,
       optimizePrompt: opts.optimizePrompt,
+      negativePrompt: opts.negativePrompt,
+      creativity: opts.creativity,
+      promptExtend: opts.promptExtend,
+      styleReferenceCount: styleReferences?.length,
+      moodboardCount: moodboards?.length,
       responseFormat: opts.responseFormat,
       imageCount: opts.image?.length,
       hasMask: Boolean(opts.mask)
@@ -1501,6 +1676,11 @@ function registerGen(program) {
     if (opts.seed !== void 0) body.seed = opts.seed;
     if (opts.quality) body.quality = opts.quality;
     if (opts.background) body.background = opts.background;
+    if (opts.negativePrompt) body.negative_prompt = opts.negativePrompt;
+    if (opts.creativity) body.creativity = opts.creativity.toLowerCase();
+    if (opts.promptExtend !== void 0) body.prompt_extend = opts.promptExtend;
+    if (styleReferences) body.image_style_references = styleReferences;
+    if (moodboards) body.moodboards = moodboards;
     if (opts.watermark !== void 0) body.watermark = opts.watermark;
     if (opts.outputFormat) body.output_format = opts.outputFormat.toLowerCase();
     if (opts.optimizePrompt) body.optimize_prompt_options = { thinking: opts.optimizePrompt.toLowerCase() };
@@ -1644,7 +1824,7 @@ function registerGen(program) {
       if (res.id) info(`\u4EA4\u4E92 ID\uFF1A${res.id}`);
     }
   });
-  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\u7CBE\u786E\u8303\u56F4\u8FD0\u884C focalapi models get <model> \u67E5\u770B", (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>", "Grok \u89C6\u9891\u539F\u751F\u753B\u9762\u6BD4\u4F8B\uFF0C\u5982 16:9\u30019:16\u3001auto").option("--seed <n>", "Grok \u89C6\u9891\u968F\u673A\u79CD\u5B50\uFF08\u975E\u8D1F\u6574\u6570\uFF09", (v) => Number.parseInt(v, 10)).option("--image <url...>", "\u56FE\u751F\u89C6\u9891\u7684\u6E90\u56FE\u50CF URL\uFF0C\u53EF\u591A\u4E2A").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("--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-compatible content JSON array; overrides prompt/image facade fields").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\u7CBE\u786E\u8303\u56F4\u8FD0\u884C focalapi models get <model> \u67E5\u770B", (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...>", "\u56FE\u751F\u89C6\u9891\u7684\u6E90\u56FE\u50CF URL\uFF0C\u53EF\u591A\u4E2A").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("--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-compatible content JSON array; overrides prompt/image facade fields").action(
     async (promptParts, opts, cmd) => {
       const g = cmd.optsWithGlobals();
       const auth = resolveAuth(g);
@@ -1662,6 +1842,8 @@ function registerGen(program) {
       if (opts.ratio) metadata.ratio = opts.ratio;
       if (opts.aspectRatio) metadata.ratio = opts.aspectRatio;
       if (opts.seed !== void 0) metadata.seed = opts.seed;
+      if (opts.fps !== void 0) metadata.fps = opts.fps;
+      if (opts.safetyTolerance !== void 0) metadata.safety_tolerance = opts.safetyTolerance;
       if (opts.generateAudio !== void 0) metadata.generate_audio = opts.generateAudio;
       if (opts.watermark !== void 0) metadata.watermark = opts.watermark;
       if (opts.serviceTier) metadata.service_tier = opts.serviceTier;
@@ -1677,6 +1859,8 @@ function registerGen(program) {
         ratio: opts.ratio,
         aspectRatio: opts.aspectRatio,
         seed: opts.seed,
+        fps: opts.fps,
+        safetyTolerance: opts.safetyTolerance,
         serviceTier: opts.serviceTier,
         priority: opts.priority,
         executionExpiresAfter: opts.executionExpiresAfter,
@@ -1762,8 +1946,8 @@ function registerTask(program) {
 import { writeFile as writeFile2 } from "fs/promises";
 import { resolve as resolve3 } from "path";
 function registerAudio(program) {
-  const audio = program.command("audio").description("\u97F3\u9891\uFF1A\u8F6C\u5199\u4E0E\u5408\u6210");
-  audio.command("transcribe").description("\u8BED\u97F3\u8F6C\u6587\u5B57").argument("<file>", "\u97F3\u9891\u6587\u4EF6\u8DEF\u5F84").requiredOption("-m, --model <model>", "\u8F6C\u5199\u6A21\u578B ID").option("--language <lang>", "\u8BED\u8A00\u4EE3\u7801\uFF08\u5982 zh\u3001en\uFF09").action(async (file, opts, cmd) => {
+  const audio = program.command("audio").description("\u97F3\u9891\uFF1A\u8F6C\u5199\u4E0E\u5408\u6210\uFF08\u6CA1\u6709\u9ED8\u8BA4\u6A21\u578B\uFF1B\u5148\u8FD0\u884C focalapi models list \u67E5\u770B\u5F53\u524D Key \u53EF\u7528\u7684\u97F3\u9891\u6A21\u578B\uFF09");
+  audio.command("transcribe").description("\u8BED\u97F3\u8F6C\u6587\u5B57").argument("<file>", "\u97F3\u9891\u6587\u4EF6\u8DEF\u5F84").requiredOption("-m, --model <model>", "\u8F6C\u5199\u6A21\u578B ID\uFF08\u5FC5\u586B\u3001\u65E0\u9ED8\u8BA4\u503C\uFF1B\u8FD0\u884C focalapi models list \u67E5\u770B\uFF09").option("--language <lang>", "\u8BED\u8A00\u4EE3\u7801\uFF08\u5982 zh\u3001en\uFF09").action(async (file, opts, cmd) => {
     const g = cmd.optsWithGlobals();
     const auth = resolveAuth(g);
     const input = readInputFile(file);
@@ -1784,7 +1968,7 @@ function registerAudio(program) {
       process.stdout.write((res.text ?? JSON.stringify(res)) + "\n");
     }
   });
-  audio.command("speech").description("\u6587\u5B57\u8F6C\u8BED\u97F3\uFF0C\u4EA7\u7269\u4FDD\u5B58\u4E3A\u97F3\u9891\u6587\u4EF6").argument("<text...>", "\u8981\u5408\u6210\u7684\u6587\u672C").requiredOption("-m, --model <model>", "TTS \u6A21\u578B ID").option("--voice <voice>", "\u97F3\u8272", "alloy").option("--format <fmt>", "\u97F3\u9891\u683C\u5F0F\uFF08mp3/wav/...\uFF09", "mp3").option("-o, --out <file>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84").action(async (textParts, opts, cmd) => {
+  audio.command("speech").description("\u6587\u5B57\u8F6C\u8BED\u97F3\uFF0C\u4EA7\u7269\u4FDD\u5B58\u4E3A\u97F3\u9891\u6587\u4EF6").argument("<text...>", "\u8981\u5408\u6210\u7684\u6587\u672C").requiredOption("-m, --model <model>", "TTS \u6A21\u578B ID\uFF08\u5FC5\u586B\u3001\u65E0\u9ED8\u8BA4\u503C\uFF1B\u8FD0\u884C focalapi models list \u67E5\u770B\uFF09").option("--voice <voice>", "\u97F3\u8272", "alloy").option("--format <fmt>", "\u97F3\u9891\u683C\u5F0F\uFF08mp3/wav/...\uFF09", "mp3").option("-o, --out <file>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84").action(async (textParts, opts, cmd) => {
     const g = cmd.optsWithGlobals();
     const auth = resolveAuth(g);
     const res = await rawRequest({

package/package.json

@@ -1,53 +1,57 @@
-{
-  "name": "focalapi-cli",
-  "version": "0.2.0",
-  "description": "让任意 AI Agent 直接调用 focalapi 创作模型的命令行工具",
-  "type": "module",
-  "bin": {
-    "focalapi": "dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "scripts",
-    "skills",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "postinstall": "node scripts/postinstall.cjs",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "keywords": [
-    "focalapi",
-    "ai",
-    "agent",
-    "cli",
-    "llm",
-    "image-generation",
-    "video-generation"
-  ],
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/xnn-ai/focalapi-cli.git"
-  },
-  "dependencies": {
-    "commander": "^12.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.0",
-    "tsup": "^8.2.4",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.4",
-    "vitest": "^2.1.9"
-  }
-}
+{
+  "name": "focalapi-cli",
+  "version": "0.2.2",
+  "description": "让任意 AI Agent 直接调用 focalapi 创作模型的命令行工具",
+  "type": "module",
+  "bin": {
+    "focalapi": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "skills",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node scripts/postinstall.cjs",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "focalapi",
+    "ai",
+    "agent",
+    "cli",
+    "llm",
+    "image-generation",
+    "video-generation"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/focalapi/focalapi-cli.git"
+  },
+  "homepage": "https://github.com/focalapi/focalapi-cli#readme",
+  "bugs": {
+    "url": "https://github.com/focalapi/focalapi-cli/issues"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.2.4",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.9"
+  }
+}

package/scripts/postinstall.cjs

@@ -1,41 +1,41 @@
-#!/usr/bin/env node
-
-/**
- * npm 全局安装后的 best-effort Agent 接入。
- *
- * 只运行本地 connect：不联网、不读取 API Key、不改 Agent provider。没有检测到
- * Agent 或接入失败都不影响 CLI 安装；用户之后可运行 focalapi connect 修复。
- */
-
-const { existsSync } = require('node:fs');
-const { join } = require('node:path');
-const { spawnSync } = require('node:child_process');
-
-if (process.env.FOCALAPI_SKIP_POSTINSTALL === '1' || process.env.CI === '1' || process.env.CI === 'true') {
-  process.exit(0);
-}
-
-const cli = join(__dirname, '..', 'dist', 'cli.js');
-if (!existsSync(cli)) process.exit(0);
-
-const result = spawnSync(process.execPath, [cli, 'connect', 'install', '--json'], {
-  encoding: 'utf8',
-  env: process.env,
-  windowsHide: true,
-});
-
-if (result.status === 0) {
-  try {
-    const output = JSON.parse(result.stdout || '{}');
-    const count = Array.isArray(output.installed) ? output.installed.length : 0;
-    if (count > 0) console.log(`focalapi-cli: 已自动接入 ${count} 个 Agent Skills 目录；重启 Agent 后生效。`);
-  } catch {
-    // connect 成功但输出不可解析不影响安装。
-  }
-  process.exit(0);
-}
-
-if (!String(result.stderr).includes('未检测到本机 Agent')) {
-  console.warn('focalapi-cli: Agent Skills 自动接入未完成；请稍后运行 `focalapi connect`。');
-}
-process.exit(0);
+#!/usr/bin/env node
+
+/**
+ * Best-effort Agent integration after global npm installation.
+ *
+ * Run local connect only: do not access the network, read an API key, or change an Agent provider.
+ * Missing Agents or integration failures never fail CLI installation; users can run focalapi connect later.
+ */
+
+const { existsSync } = require('node:fs');
+const { join } = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+if (process.env.FOCALAPI_SKIP_POSTINSTALL === '1' || process.env.CI === '1' || process.env.CI === 'true') {
+  process.exit(0);
+}
+
+const cli = join(__dirname, '..', 'dist', 'cli.js');
+if (!existsSync(cli)) process.exit(0);
+
+const result = spawnSync(process.execPath, [cli, 'connect', 'install', '--json'], {
+  encoding: 'utf8',
+  env: process.env,
+  windowsHide: true,
+});
+
+if (result.status === 0) {
+  try {
+    const output = JSON.parse(result.stdout || '{}');
+    const count = Array.isArray(output.installed) ? output.installed.length : 0;
+    if (count > 0) console.log(`focalapi-cli: 已自动接入 ${count} 个 Agent Skills 目录；重启 Agent 后生效。`);
+  } catch {
+    // Unparseable output after a successful connect must not fail installation.
+  }
+  process.exit(0);
+}
+
+if (!String(result.stderr).includes('未检测到本机 Agent')) {
+  console.warn('focalapi-cli: Agent Skills 自动接入未完成；请稍后运行 `focalapi connect`。');
+}
+process.exit(0);