Meshy

Cancel a Creative Lab task only while it is PENDING or IN_PROGRESS. Terminal task history is retained. Canceling a PENDING task refunds its credits; canceling an IN_PROGRESS task does not refund credits.

Start a 3-credit task that applies either a selected library animation or a succeeded Text to Motion clip to a completed rigging task and return the animation task ID.

Split a succeeded untextured Meshy 6 or Meshy 7 model into separately printable parts and return the task ID. An accepted task costs 10 credits; failed tasks are refunded, as is a task deleted while still pending.

Start an entitled 6-credit task that generates a collapsible fidget directly from an image and return the task ID.

Start a 1-credit task that converts a model into one or more requested formats; returns the task ID.

Start a 3D build from a succeeded matching Creative Lab prototype. Lamp builds cost 6 credits, keycap builds cost 50, and all other builds cost 30. The call returns a build task ID.

Start an entitled image-to-prototype task for a fixed Creative Lab product. Lamp prototypes cost 30 credits, keycap prototypes cost 12, and all other prototypes cost 6. The task ID can be passed to the matching build operation.

Start a 3D generation task from one to four views of one object or a prior task's input images. One image uses single-image generation and two to four use multi-image generation. Meshy-6/7 cost 20 credits without texture, 30 with texture, or 35 with 8K texture; single-image Meshy T2 costs 5, 15, or 20 respectively; other models cost 5 without or 15 with texture. Ultra on Meshy-7 adds 5 credits. Returns task_id and the exact task_type discriminator for GET_TASK, LIST_TASKS, or DELETE_TASK.

Start a credit-consuming task that edits or restyles one to five reference images from a text instruction. The task costs 3 to 12 credits depending on the model and returns a task ID for status checks.

Start a 10-credit task that converts a GLB or FBX model from a prior Meshy task or direct URL into a limited-color 3MF for 3D printing, and return the task ID. When both sources are provided, input_task_id takes precedence.

Start a free task that analyzes a GLB, GLTF, OBJ, FBX, or STL model from a prior Meshy task or direct URL for printability defects and return the task ID. When both sources are provided, input_task_id takes precedence.

Start a 10-credit task that repairs a GLB, GLTF, OBJ, FBX, or STL model from a prior Meshy task or direct URL for 3D printing and return the task ID. When both sources are provided, input_task_id takes precedence. The repaired asset retains the input format.

Start a 5-credit task that remeshes a model to the requested topology and polygon count, optionally resizes it, and exports the remeshed result in the requested formats. Use CREATE_CONVERT_TASK for format conversion without remeshing. Returns the remesh task ID.

Start a 1-credit task that scales a model by height, longest side, or automatic sizing and return the task ID.

Start a credit-consuming task that applies one text, image, or multiview style source to an existing 3D model. The task costs 10 credits at 2k or 4k resolution and 15 credits at 8k, and returns a task ID for status checks.

Start a 5-credit task that rigs a GLB character with a biped or quadruped skeleton and return the task ID. Models above 300,000 faces must be remeshed first.

Start a new Text to 3D preview or fused geometry-and-texture task and return its task ID. Preview costs 20 credits for Meshy 6/7, 5 credits for Meshy T2 or other models, and Ultra adds 5 credits; fused generation costs 30 credits for Meshy 6/7 or 15 for Meshy T2 and other models. Use REFINE_TEXT_TO_3D_TASK to texture a succeeded preview.

Start a credit-consuming 2D image generation task from a text prompt. The task costs 3 to 9 credits depending on the model and returns a task ID for status checks.

Start an entitled motion-generation task from a text prompt and return its task ID. Prime mode costs 10 credits and the completed task produces FBX; swift mode costs 3 credits and the completed task produces BVH.

Start a 5-credit task that generates UV coordinates for a GLB model and return the task ID. High-poly models may need to be remeshed first.

Permanently delete a GA or Text-to-Motion task and its retained outputs. Creative Lab tasks cannot be deleted with this action; use CANCEL_CREATIVE_LAB_TASK for an active Creative Lab task.

Return the connected Meshy account's available credit balance before starting paid generation tasks.

Retrieve current status, errors, and available outputs for one task from a selected Meshy task family. This read does not consume credits.

Search or filter Meshy's unpaginated animation catalog and return action IDs for use when creating animation tasks.

Return one page of tasks for one selected Meshy task family, with an opaque cursor for safe continuation. This read does not consume credits.

Return one page of terminal API-task usage and consumed credits for the connected Meshy team. This endpoint is available only to Studio and Enterprise team API keys. Pass next_cursor alone to continue the same filtered export; split exports into windows of at most one year.

Apply texture to a succeeded Text to 3D preview and return the new refine task ID. Refinement costs 10 credits at 2k or 4k texture resolution and 15 credits at 8k.