[Arlieeee]

Aligns meshy-cli with the current public API: request shapes the API actually accepts, polling that follows the documented task lifecycle, new endpoints (Auto Split, Usage, the animation library), the newer Creative Lab products, and the printability, animation, image, balance and generation parameters the docs list. Version 0.4.2.

Fixed

• every --model-url (remesh, convert, resize, retexture, multi-color-print, analyze/repair-printability): a local model must be .glb/.gltf (multi-color-print: .glb) because the API takes inline models as glTF only; .stl/.obj/.fbx are refused before the request with a pointer to an http(s) URL or --input-task-id. A data:application/octet-stream URI is accepted when it holds a GLB
• text-to-3d refine no longer pins remove_lighting and a 4k texture, which a meshy-6-lite preview refuses; make still refines at 4k and its resume command says so
• image-to-3d --model-type smart-topology refuses --remove-lighting / --image-enhancement locally
• wait / sync create / make: a 429, 5xx, read timeout or dropped connection on a status request is retried at the next tick, paced by Retry-After; an outage that outlasts --timeout is exit 8 with the task id
• 409 on delete (task IN_PROGRESS) is a new conflict error, exit 14: the task cannot be stopped and its credits are spent, so the recovery is the resource's wait for the result (none from the top-level delete, which does not know the resource); deleting it after it finishes is permanent with no refund
• v1 resources lists delete as kind action with its endpoint (it was local); counts.action added
• meshy delete says it covers every resource except Creative Lab; Creative Lab delete reports canceled: true, deleted: false
• animation tasks are typed animate, so download --task-json matches them

Added

• auto-split (/print/split): create / get / list / wait / stream / delete
• usage tasks (GET /usage/tasks, Studio/Enterprise)
• animation-catalog list on the documented /animations/library endpoint (server-side search, category, sub-category, action ids)
• animate --action-ids (up to 10 clips in one file) and --motion-task-id; rigging list
• printability --printer-type, --intended-print-height-mm, --intended-print-longest-side-mm; repair --alpha-thumbnail
• multi-color-print --style, --printer-brand
• text-to-image / image-to-image --remove-background; image-to-image --input-task-id
• balance reports monthly_credits, permanent_credits, monthly_resets_at
• --geometry-resolution on text-to-3d preview and image-to-3d (--ultra-mode kept as its deprecated spelling); text-to-3d --model-type smart-topology --target-polycount (default 10000, like image-to-3d); multi-image-to-3d --texture-image-urls
• Creative Lab: vinyl-figure, brick-figure, keycap (--candidate-id), fidget-pixel (--type), fidget-collapsible (single stage); keychain --name-text
• --alpha-thumbnail on retexture / remesh; rigging --texture-image-url

Changed

• help text: 800-character prompts, latest = Meshy 7.1 (multi-image-to-3d too, no longer called beta), image-to-3d --remove-lighting applies on meshy-6 only, emission maps only on meshy-6, --enable-original-uv defaults to false, repair input formats, --timeout wording (the task keeps running; the API advises up to 60 min)
• docs and comments describe API behaviour only
• version 0.4.2

Typecheck and the full suite (638 tests, loopback API only) pass. Every new command and flag was also run end to end against the live API (auto-split, animate --action-ids / --motion-task-id, text-to-motion, printability with --printer-type, multi-color --style / --printer-brand, image --remove-background / --input-task-id, the new Creative Lab products and fidget-pixel build, --geometry-resolution, smart topology, rigging list, animation-catalog, 409 → exit 14, download --task-json on an animate task).

Release notes (draft)

Highlights

• New commands. meshy auto-split splits a model into printable parts (automatically, by named parts or by colour, with optional connectors). meshy usage tasks lists finished API tasks with the credits each consumed (Studio/Enterprise).
• More Creative Lab products. vinyl-figure, brick-figure, keycap (build with --candidate-id), fidget-pixel (--type person|other) and the single-stage fidget-collapsible; keychains take an engraving with --name-text.
• Animation. animate --action-ids puts up to 10 library actions in one file; --motion-task-id retargets a text-to-motion clip. animation-catalog list now uses the documented library endpoint with server-side filters (it needs an API key). rigging list works.
• New parameters. Printability print size and printer type (wall-thickness check / thickening), multi-color --style and --printer-brand, --remove-background on the image commands, image-to-image --input-task-id, --geometry-resolution 2k|4k on text-to-3d preview and image-to-3d, text-to-3d smart topology, multi-image --texture-image-urls, --alpha-thumbnail on retexture/remesh/repair, rigging --texture-image-url. balance shows monthly and permanent credits and the next reset.
• Waiting is sturdier. A 429, 5xx or timeout on a status request no longer ends wait: it is retried at the next poll, paced by Retry-After.
• Behaviour changes to note.
  • delete of a running task exits 14 (conflict): it cannot be stopped and its credits are spent; wait for the result, and delete it afterwards only if it should be gone (permanent, no refund).
  • meshy resources --output-schema v1 lists delete as kind action.
  • Creative Lab delete reports canceled: true, deleted: false.
  • A standalone text-to-3d refine no longer sends remove_lighting: true or a 4k texture by default (a meshy-6-lite preview refuses them); pass --remove-lighting true --texture-resolution 4k for the previous request. make still refines at 4k.
  • A local --model-url must be .glb/.gltf (multi-color-print: .glb) on every command: the API takes inline models as glTF only, so .stl/.obj/.fbx now fail before the request — pass them as an http(s) URL or use --input-task-id.
  • animation-catalog list uses the documented library endpoint and now needs an API key. Its v1 result drops fetched, total and authenticated, search_scope is "server", and items no longer carry rig_type, is_free or is_default. --search matches name and key only; use --sub-category to filter by sub-category.

npm install -g [email protected]   # or @meshy-ai/[email protected]

🤖 Generated with Claude Code