@meshy-ai/cli 0.3.0 → 0.3.1

package/README.md

@@ -347,7 +347,8 @@ status report instead of JSON. Single-file outputs get a per-file
 task that is not yet SUCCEEDED yields `downloads.state: "not_ready"` with exit 0.
 
 ```bash
-meshy-cli text-to-image create --ai-model nano-banana --prompt "a leaf" -o assets/leaf.jpeg
+meshy-cli text-to-image create --ai-model nano-banana-2-lite --prompt "a leaf" -o assets/leaf.jpeg
+meshy-cli text-to-image create --ai-model gpt-image-2-5-sunburst --aspect-ratio 3:2 --prompt "a leaf" -o assets/leaf-wide.png
 meshy-cli image-to-3d wait <id> -o out/robot/
 ```
 

package/dist/internal/image-models.d.ts

@@ -1,15 +1,22 @@
 /**
  * Shared model/aspect-ratio table for the 2D image commands, so text-to-image
  * and image-to-image can't drift apart as Meshy ships new models.
+ *
+ * The ratio rules mirror the server's own per-model check
+ * (meshyd pkg/server/api_image_generation_handlers.go): every GPT Image model
+ * accepts all seven ratios; the nano-banana family rejects 3:2 and 2:3.
  */
-export declare const IMAGE_MODELS: readonly ["gpt-image-2", "nano-banana-pro", "nano-banana-2", "nano-banana-2-lite", "nano-banana"];
+export declare const IMAGE_MODELS: readonly ["gpt-image-2", "gpt-image-2-5-flare", "gpt-image-2-5-sunburst", "nano-banana-pro", "nano-banana-2", "nano-banana-2-lite"];
 export declare const DEFAULT_IMAGE_MODEL = "gpt-image-2";
+/** OpenAI GPT Image models of any generation — the ones that take every aspect ratio. */
+export declare const GPT_IMAGE_MODELS: readonly ["gpt-image-2", "gpt-image-2-5-flare", "gpt-image-2-5-sunburst"];
 export declare const IMAGE_MODEL_HELP: string;
 export declare const ASPECT_RATIOS: readonly ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"];
 export declare const ASPECT_RATIO_HELP: string;
+export declare function isGptImageModel(model: string): boolean;
 /**
  * Cross-validate model × aspect-ratio × multi-view before any credits are
- * spent; the API's own 400 is less specific. When the model is unknown at
+ * spent, with a message that names the fix. When the model is unknown at
  * parse time (driven via --data), the ratio check is left to the server.
  */
 export declare function checkImageCombo(opts: {

package/dist/internal/image-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-models.d.ts","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,YAAY,YACvB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,aAAa,CACL,CAAC;AAEX,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,eAAO,MAAM,gBAAgB,QAEoC,CAAC;AAElE,eAAO,MAAM,aAAa,YAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1F,eAAO,MAAM,iBAAiB,QAGmB,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,IAAI,CAcP"}
+{"version":3,"file":"image-models.d.ts","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,YAAY,YACvB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,CACZ,CAAC;AAEX,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,YAAI,aAAa,EAAE,qBAAqB,EAAE,wBAAwB,CAAU,CAAC;AAE1G,eAAO,MAAM,gBAAgB,QAG6B,CAAC;AAE3D,eAAO,MAAM,aAAa,YAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1F,eAAO,MAAM,iBAAiB,QAGmB,CAAC;AAKlD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,IAAI,CAcP"}

package/dist/internal/image-models.js

@@ -1,27 +1,38 @@
 /**
  * Shared model/aspect-ratio table for the 2D image commands, so text-to-image
  * and image-to-image can't drift apart as Meshy ships new models.
+ *
+ * The ratio rules mirror the server's own per-model check
+ * (meshyd pkg/server/api_image_generation_handlers.go): every GPT Image model
+ * accepts all seven ratios; the nano-banana family rejects 3:2 and 2:3.
  */
 import { UsageError } from "./errors.js";
 export const IMAGE_MODELS = [
     "gpt-image-2",
+    "gpt-image-2-5-flare",
+    "gpt-image-2-5-sunburst",
     "nano-banana-pro",
     "nano-banana-2",
     "nano-banana-2-lite",
-    "nano-banana",
 ];
 export const DEFAULT_IMAGE_MODEL = "gpt-image-2";
-export const IMAGE_MODEL_HELP = "gpt-image-2 (default, best; ratios 1:1|16:9|9:16|3:2|2:3) | nano-banana-pro | nano-banana-2 | " +
-    "nano-banana-2-lite (fastest, cheapest) | nano-banana (legacy)";
+/** OpenAI GPT Image models of any generation — the ones that take every aspect ratio. */
+export const GPT_IMAGE_MODELS = ["gpt-image-2", "gpt-image-2-5-flare", "gpt-image-2-5-sunburst"];
+export const IMAGE_MODEL_HELP = "gpt-image-2 (default) | gpt-image-2-5-flare (GPT Image 2.5, fast tier) | " +
+    "gpt-image-2-5-sunburst (GPT Image 2.5, precision-edit tier) | nano-banana-pro | " +
+    "nano-banana-2 | nano-banana-2-lite (fastest, cheapest)";
 export const ASPECT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"];
-export const ASPECT_RATIO_HELP = "default: 1:1. nano-banana*: 1:1|16:9|9:16|4:3|3:4. " +
-    "gpt-image-2: 1:1|16:9|9:16|3:2|2:3. " +
+export const ASPECT_RATIO_HELP = "default: 1:1. gpt-image-*: 1:1|16:9|9:16|4:3|3:4|3:2|2:3. " +
+    "nano-banana*: 1:1|16:9|9:16|4:3|3:4. " +
     "Mutually exclusive with --generate-multi-view";
-const GPT_IMAGE_2_RATIOS = new Set(["1:1", "16:9", "9:16", "3:2", "2:3"]);
+const GPT_IMAGE_MODEL_SET = new Set(GPT_IMAGE_MODELS);
 const NANO_BANANA_RATIOS = new Set(["1:1", "16:9", "9:16", "4:3", "3:4"]);
+export function isGptImageModel(model) {
+    return GPT_IMAGE_MODEL_SET.has(model);
+}
 /**
  * Cross-validate model × aspect-ratio × multi-view before any credits are
- * spent; the API's own 400 is less specific. When the model is unknown at
+ * spent, with a message that names the fix. When the model is unknown at
  * parse time (driven via --data), the ratio check is left to the server.
  */
 export function checkImageCombo(opts) {
@@ -31,11 +42,12 @@ export function checkImageCombo(opts) {
     const ratio = opts.aspectRatio;
     if (!ratio || !opts.aiModel)
         return;
-    const supported = opts.aiModel === "gpt-image-2" ? GPT_IMAGE_2_RATIOS : NANO_BANANA_RATIOS;
-    if (!supported.has(ratio)) {
-        throw new UsageError(opts.aiModel === "gpt-image-2"
-            ? `--aspect-ratio ${ratio} is not supported by gpt-image-2 (use 1:1, 16:9, 9:16, 3:2, or 2:3)`
-            : `--aspect-ratio ${ratio} is only supported by gpt-image-2`);
+    // GPT Image models (2 and 2.5) accept every ratio the flag offers; only the
+    // nano-banana family is narrower.
+    if (isGptImageModel(opts.aiModel))
+        return;
+    if (!NANO_BANANA_RATIOS.has(ratio)) {
+        throw new UsageError(`--aspect-ratio ${ratio} is only supported by the GPT Image models (${GPT_IMAGE_MODELS.join(", ")})`);
     }
 }
 //# sourceMappingURL=image-models.js.map

package/dist/internal/image-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-models.js","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,gGAAgG;IAChG,+DAA+D,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1F,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qDAAqD;IACrD,sCAAsC;IACtC,+CAA+C,CAAC;AAElD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAC1E,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC3F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAClB,IAAI,CAAC,OAAO,KAAK,aAAa;YAC5B,CAAC,CAAC,kBAAkB,KAAK,qEAAqE;YAC9F,CAAC,CAAC,kBAAkB,KAAK,mCAAmC,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"image-models.js","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,qBAAqB;IACrB,wBAAwB;IACxB,iBAAiB;IACjB,eAAe;IACf,oBAAoB;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,aAAa,EAAE,qBAAqB,EAAE,wBAAwB,CAAU,CAAC;AAE1G,MAAM,CAAC,MAAM,gBAAgB,GAC3B,2EAA2E;IAC3E,kFAAkF;IAClF,wDAAwD,CAAC;AAE3D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1F,MAAM,CAAC,MAAM,iBAAiB,GAC5B,4DAA4D;IAC5D,uCAAuC;IACvC,+CAA+C,CAAC;AAElD,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC3E,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE/F,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO;IACpC,4EAA4E;IAC5E,kCAAkC;IAClC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO;IAC1C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAClB,kBAAkB,KAAK,+CAA+C,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshy-ai/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Official command-line interface for the Meshy AI API — text-to-3D, image-to-3D, text-to-motion, remesh, UV unwrap, rigging, animate, retexture, 2D images, multi-color print, Creative Lab, balance — plus selective downloads, project folders, face checks, OBJ print preparation and slicer launch.",
   "license": "MIT",
   "type": "module",