- Category: media generation
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 27
- Triggers: 0
- Slug:
MESHY - Version: 20261101_00
Tools
Cancel Creative Lab Task
Cancel Creative Lab Task
MESHY_CANCEL_CREATIVE_LAB_TASKRequest deletion of a Creative Lab task by type and ID. Deleting a pending task cancels it and refunds credits; in-progress tasks cannot be canceled, while terminal tasks can be deleted.Input Parameters
Output
Create Animation Task
Create Animation Task
MESHY_CREATE_ANIMATION_TASKStart 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.Input Parameters
Output
Create Auto Split Task
Create Auto Split Task
MESHY_CREATE_AUTO_SPLIT_TASKSplit 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.Input Parameters
Output
Create Collapsible Fidget Task
Create Collapsible Fidget Task
Create Convert Task
Create Convert Task
MESHY_CREATE_CONVERT_TASKStart a 1-credit task that converts a model into one or more requested formats; returns the task ID.Input Parameters
Output
Create Creative Lab Build
Create Creative Lab Build
MESHY_CREATE_CREATIVE_LAB_BUILDStart 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.Input Parameters
Output
Create Creative Lab Prototype
Create Creative Lab Prototype
MESHY_CREATE_CREATIVE_LAB_PROTOTYPEStart 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.Input Parameters
Output
Create Image to 3D Task
Create Image to 3D Task
MESHY_CREATE_IMAGE_TO_3D_TASKStart 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.Input Parameters
Output
Create Image to Image Task
Create Image to Image Task
MESHY_CREATE_IMAGE_TO_IMAGE_TASKStart 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.Input Parameters
Output
Create Multi-Color Print Task
Create Multi-Color Print Task
MESHY_CREATE_MULTI_COLOR_PRINT_TASKStart 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.Input Parameters
Output
Create Print Analysis Task
Create Print Analysis Task
MESHY_CREATE_PRINT_ANALYSIS_TASKStart 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.Input Parameters
Output
Create Print Repair Task
Create Print Repair Task
MESHY_CREATE_PRINT_REPAIR_TASKStart 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.Input Parameters
Output
Create Remesh Task
Create Remesh Task
MESHY_CREATE_REMESH_TASKStart 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.Input Parameters
Output
Create Resize Task
Create Resize Task
MESHY_CREATE_RESIZE_TASKStart a 1-credit task that scales a model by height, longest side, or automatic sizing and return the task ID.Input Parameters
Output
Create Retexture Task
Create Retexture Task
MESHY_CREATE_RETEXTURE_TASKStart 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.Input Parameters
Output
Create Rigging Task
Create Rigging Task
MESHY_CREATE_RIGGING_TASKStart 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.Input Parameters
Output
Create Text to 3D Task
Create Text to 3D Task
MESHY_CREATE_TEXT_TO_3D_TASKStart 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.Input Parameters
Output
Create Text to Image Task
Create Text to Image Task
MESHY_CREATE_TEXT_TO_IMAGE_TASKStart 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.Input Parameters
Output
Create Text to Motion Task
Create Text to Motion Task
MESHY_CREATE_TEXT_TO_MOTION_TASKStart 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.Input Parameters
Output
Create UV Unwrap Task
Create UV Unwrap Task
MESHY_CREATE_UV_UNWRAP_TASKStart 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.Input Parameters
Output
Delete Task
Delete Task
MESHY_DELETE_TASKDelete a GA or Text-to-Motion task and its retained outputs. A pending task is canceled and refunded; an in-progress task cannot be deleted until it reaches a terminal status.Input Parameters
Output
Get Credit Balance
Get Credit Balance
Get Task
Get Task
List Animation Library
List Animation Library
List Tasks
List Tasks
MESHY_LIST_TASKSReturn one page of tasks for a selected Meshy task family, with a cursor for continuing to the next page. This read does not consume credits.Input Parameters
Output
List Usage Records
List Usage Records
MESHY_LIST_USAGE_RECORDSReturn one page of terminal API-task usage and consumed credits for a Meshy team using a Studio or Enterprise team API key. Continue filtered exports with the cursor; pagination stops at page 255, so use smaller time windows for larger exports.Input Parameters
Output
Refine Text to 3D Task
Refine Text to 3D Task
MESHY_REFINE_TEXT_TO_3D_TASKApply 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.