> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Meshy

> Meshy provides generative 3D, image, motion, animation, model-processing, and Creative Lab APIs.

![Meshy logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/meshy.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=75c239315ac8fe4bd4c54a9fa4af1402)

* **Category:** media generation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 27
* **Triggers:** 0
* **Slug:** `MESHY`
* **Version:** 20261101\_00

## Tools

> [accordion] Cancel Creative Lab Task
>
> **Slug:** `MESHY_CANCEL_CREATIVE_LAB_TASK`
>
> Request 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
>
> **task\_id** `string` *required*
>
> ID of a PENDING or IN\_PROGRESS Creative Lab task to cancel.
>
> **task\_type** `string ("creative_lab_keychain_prototype" | "creative_lab_keychain_build" | "creative_lab_fridge_magnet_prototype" | "creative_lab_fridge_magnet_build" | "creative_lab_figure_prototype" | "creative_lab_figure_build" | "creative_lab_vinyl_figure_prototype" | "creative_lab_vinyl_figure_build" | "creative_lab_brick_figure_prototype" | "creative_lab_brick_figure_build" | "creative_lab_lamp_prototype" | "creative_lab_lamp_build" | "creative_lab_keycap_prototype" | "creative_lab_keycap_build" | "creative_lab_fidget_pixel_prototype" | "creative_lab_fidget_pixel_build" | "creative_lab_fidget_collapsible")` *required*
>
> Creative Lab task family that owns the ID; selects a fixed documented cancellation endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Animation Task
>
> **Slug:** `MESHY_CREATE_ANIMATION_TASK`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name.
>
> **action\_id** `integer`
>
> Identifier of the preset animation action to apply, returned by MESHY\_LIST\_ANIMATION\_LIBRARY. Provide exactly one of action\_id or motion\_task\_id.
>
> **rig\_task\_id** `string` *required*
>
> Completed Meshy rigging task ID whose model will be animated.
>
> **post\_process** `object`
>
> Optional post-processing operation for changing frame rate, converting FBX to USDZ, or extracting the armature.
>
> **motion\_task\_id** `string`
>
> ID of a successfully completed Text to Motion task to apply instead of a preset action. The generated clip is retargeted onto the rigged character and snapshotted when this task is created. Source assets are retained for 3 days, so apply the clip before it expires. Requires a biped rig. Provide exactly one of action\_id or motion\_task\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Auto Split Task
>
> **Slug:** `MESHY_CREATE_AUTO_SPLIT_TASK`
>
> 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.
>
> #### Input Parameters
>
> **mode** `string ("auto" | "by_parts" | "by_color")`
>
> Split automatically, by named structural parts, or by named color regions. by\_color requires an Image to 3D or Multi-Image to 3D source.
>
> **layout** `string ("assembled" | "on_plate")`
>
> Keep parts assembled or lay them out separately on a build plate.
>
> **prompt** `string`
>
> One to ten part names in any language, not a general description. Required for by\_parts and by\_color and ignored for auto. Meshy rejects prompts naming fewer than two parts; an unreadable prompt falls back to auto and the task reports prompt\_ignored.
>
> **connectors** `boolean`
>
> Add mortise-and-tenon connectors at each cut.
>
> **input\_task\_id** `string` *required*
>
> Succeeded, untextured Meshy 6 or Meshy 7 Image to 3D, Multi-Image to 3D, Text to 3D preview, Remesh, Convert, or Resize task whose model will be split.
>
> **connector\_size** `number`
>
> Connector size relative to the cut surface. Only valid when connectors is true.
>
> **connector\_type** `string ("cube" | "cylinder")`
>
> Connector shape. Only valid when connectors is true.
>
> **target\_formats** `array`
>
> Output formats. GLB is always produced; STL is not supported.
>
> **connector\_height** `number`
>
> Connector extension relative to the cut surface. Only valid when connectors is true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Collapsible Fidget Task
>
> **Slug:** `MESHY_CREATE_COLLAPSIBLE_FIDGET_TASK`
>
> Start an entitled 6-credit task that generates a collapsible fidget directly from an image and return the task ID.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name, up to 100 characters.
>
> **image\_url** `string` *required*
>
> Public HTTP(S) URL or base64 data URI for a JPG, JPEG, PNG, or WebP source image.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Convert Task
>
> **Slug:** `MESHY_CREATE_CONVERT_TASK`
>
> Start a 1-credit task that converts a model into one or more requested formats; returns the task ID.
>
> #### Input Parameters
>
> **model\_url** `string`
>
> Model HTTP(S) URL or data URI to convert. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **input\_task\_id** `string`
>
> Prior Meshy task ID containing the model to convert. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **target\_formats** `array` *required*
>
> One or more output formats: glb, obj, fbx, stl, usdz, blend, or 3mf.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Creative Lab Build
>
> **Slug:** `MESHY_CREATE_CREATIVE_LAB_BUILD`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name.
>
> **product** `string ("keychain" | "fridge_magnet" | "figure" | "vinyl_figure" | "brick_figure" | "lamp" | "keycap" | "fidget_pixel")` *required*
>
> Creative Lab product to build. It must match the succeeded prototype task.
>
> **build\_options** `string`
>
> Required when product='keycap' and must include a non-empty candidate\_id. Optional when product is 'keychain', 'fridge\_magnet', 'lamp', or 'fidget\_pixel'. Omit for figure, vinyl\_figure, or brick\_figure; build\_options is rejected for those products.
>
> **input\_task\_id** `string` *required*
>
> Succeeded prototype task ID created for the selected product with the same Meshy API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Creative Lab Prototype
>
> **Slug:** `MESHY_CREATE_CREATIVE_LAB_PROTOTYPE`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name of at most 100 characters.
>
> **product** `string ("keychain" | "fridge_magnet" | "figure" | "vinyl_figure" | "brick_figure" | "lamp" | "keycap" | "fidget_pixel")` *required*
>
> Creative Lab product prototype to generate; selects one fixed documented endpoint.
>
> **image\_url** `string` *required*
>
> Public image URL or base64 data URI containing a JPG, JPEG, PNG, or WebP image.
>
> **product\_options** `string`
>
> Required when product='fidget\_pixel': set the nested product discriminator to 'fidget\_pixel' and provide a non-empty type. Optional when product is 'keychain' or 'lamp', with the nested product discriminator matching the top-level product. Omit for fridge\_magnet, figure, vinyl\_figure, brick\_figure, or keycap; product\_options is rejected for those products.
>
> **remove\_background** `boolean`
>
> Whether Meshy should return a transparent prototype image.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Image to 3D Task
>
> **Slug:** `MESHY_CREATE_IMAGE_TO_3D_TASK`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name, up to 100 characters.
>
> **ai\_model** `string ("meshy-5" | "meshy-6" | "meshy-7" | "latest" | "meshy-t2")`
>
> Meshy model to use. When omitted, Meshy selects the endpoint and model-type default. meshy-t2 is single-image only and requires model\_type='smart-topology'; meshy-7 may require account entitlement. Pricing before add-ons: meshy-6 and meshy-7 cost 20 credits without texture or 30 with texture; meshy-t2 costs 5 without texture or 15 with texture; other models cost 5 without texture or 15 with texture.
>
> **topology** `string ("quad" | "triangle")`
>
> Output mesh topology. Quad topology is not supported by meshy-t2.
>
> **auto\_size** `boolean`
>
> Whether to estimate the model's real-world size automatically.
>
> **origin\_at** `string ("bottom" | "center")`
>
> Place the model origin at its bottom or center.
>
> **pose\_mode** `string ("a-pose" | "t-pose")`
>
> Force an A-pose or T-pose for a character model.
>
> **enable\_pbr** `boolean`
>
> Whether to produce physically based rendering texture maps.
>
> **image\_urls** `array`
>
> One to four views of the same object. One image uses Meshy's single-image pipeline; two to four images use its multi-image pipeline. One of image\_urls or input\_task\_id is required. If both are provided, input\_task\_id takes priority and image\_urls is ignored.
>
> **model\_type** `string ("standard" | "lowpoly" | "smart-topology")`
>
> Single-image-only generation pipeline: standard, lowpoly, or smart-topology.
>
> **moderation** `boolean`
>
> Whether to run content moderation.
>
> **ultra\_mode** `boolean`
>
> Enable the high-detail pass. Ultra adds 5 credits to the applicable meshy-7 price and requires account entitlement; it requires meshy-7 for single-image or meshy-7/latest for multi-image generation.
>
> **experimental** `object`
>
> Single-image-only experimental generation options.
>
> **input\_task\_id** `string`
>
> Prior task whose input image or images should be reused. One of input\_task\_id or image\_urls is required; if both are provided, this task takes priority. Also provide input\_image\_count.
>
> **should\_remesh** `boolean`
>
> Whether to remesh after the draft stage. The default depends on the model.
>
> **should\_texture** `boolean`
>
> Whether to run the texture stage. Texturing adds 10 credits to the base 5- or 20-credit generation price.
>
> **target\_formats** `array`
>
> Additional output formats: glb, obj, fbx, stl, usdz, or 3mf.
>
> **texture\_prompt** `string`
>
> Optional texture description, up to 800 characters. If texture\_image\_url is also provided, texture\_prompt takes priority and texture\_image\_url is ignored. For multi-image generation it is mutually exclusive with texture\_image\_urls.
>
> **alpha\_thumbnail** `boolean`
>
> Whether to produce a transparent-background preview.
>
> **decimation\_mode** `integer ("1" | "2" | "3" | "4")`
>
> Decimation algorithm selector from 1 through 4.
>
> **remove\_lighting** `boolean`
>
> Whether to remove baked lighting. Not supported with smart-topology.
>
> **target\_polycount** `integer`
>
> Target polygon count from 100 to 300000. When omitted, Meshy chooses the single-image default or 30000 for multi-image generation.
>
> **image\_enhancement** `boolean`
>
> Whether to enhance the input image(s). Not supported with smart-topology.
>
> **input\_image\_count** `integer`
>
> Number of input images in input\_task\_id. Required only with input\_task\_id; 1 selects the single-image pipeline and 2-4 select the multi-image pipeline.
>
> **texture\_image\_url** `string`
>
> Optional single texture reference as an HTTP(S) URL or data URI. For single- or multi-image generation, texture\_prompt takes priority if both are provided. For multi-image generation it is mutually exclusive with texture\_image\_urls.
>
> **texture\_image\_urls** `array`
>
> Multi-image-only texture reference views, with the primary view first. Requires should\_texture and meshy-7/latest; mutually exclusive with texture\_prompt and texture\_image\_url.
>
> **texture\_resolution** `string ("2k" | "4k" | "8k")`
>
> Texture resolution tier: 2k, 4k, or 8k. An 8K texture adds 5 credits for meshy-6, meshy-7, and single-image meshy-t2, making their textured prices 35, 35, and 20 credits respectively. Other textured models remain 15 credits; meshy-5 does not support 4K or 8K.
>
> **multi\_view\_thumbnails** `boolean`
>
> Whether to render front, right, back, and left thumbnails.
>
> **save\_pre\_remeshed\_model** `boolean`
>
> Whether to include the model produced before remeshing in task outputs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Image to Image Task
>
> **Slug:** `MESHY_CREATE_IMAGE_TO_IMAGE_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.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Text instruction describing the transformation or edit to apply.
>
> **ai\_model** `string ("nano-banana" | "nano-banana-pro" | "nano-banana-2" | "gpt-image-2")` *required*
>
> Meshy image-edit model to use.
>
> **aspect\_ratio** `string ("1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3")`
>
> Output aspect ratio. gpt-image-2 supports 1:1, 16:9, 9:16, 3:2, and 2:3; nano-banana models support 1:1, 16:9, 9:16, 4:3, and 3:4. Do not set this with generate\_multi\_view.
>
> **remove\_background** `boolean`
>
> Whether to return a transparent RGBA PNG with the background removed. Available only for single-image output.
>
> **generate\_multi\_view** `boolean`
>
> Whether to generate a split image showing the subject from multiple angles. Cannot be combined with aspect\_ratio or background removal.
>
> **reference\_image\_urls** `array` *required*
>
> One to five reference images to edit from, provided as public HTTP(S) URLs or JPEG/PNG data URIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Multi-Color Print Task
>
> **Slug:** `MESHY_CREATE_MULTI_COLOR_PRINT_TASK`
>
> 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.
>
> #### Input Parameters
>
> **style** `string ("realistic" | "cartoon")`
>
> Color-placement algorithm to use.
>
> **max\_depth** `integer`
>
> Quadtree depth from 3 to 6; used by the realistic style.
>
> **model\_url** `string`
>
> HTTP(S) URL or data URI for a GLB or FBX model. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **max\_colors** `integer`
>
> Target number of colors, from 1 to 16.
>
> **input\_task\_id** `string`
>
> Prior Meshy task containing the GLB model. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Print Analysis Task
>
> **Slug:** `MESHY_CREATE_PRINT_ANALYSIS_TASK`
>
> 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.
>
> #### Input Parameters
>
> **model\_url** `string`
>
> GLB, GLTF, OBJ, FBX, or STL HTTP(S) URL or data URI. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **input\_task\_id** `string`
>
> Prior Meshy task ID containing the model to analyze. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Print Repair Task
>
> **Slug:** `MESHY_CREATE_PRINT_REPAIR_TASK`
>
> 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.
>
> #### Input Parameters
>
> **model\_url** `string`
>
> GLB, GLTF, OBJ, FBX, or STL model HTTP(S) URL or data URI. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **input\_task\_id** `string`
>
> Prior Meshy task ID containing the GLB, STL, or OBJ model to repair. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **alpha\_thumbnail** `boolean`
>
> Generate a transparent-background preview thumbnail.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Remesh Task
>
> **Slug:** `MESHY_CREATE_REMESH_TASK`
>
> 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.
>
> #### Input Parameters
>
> **topology** `string ("quad" | "triangle")`
>
> Output mesh topology.
>
> **auto\_size** `boolean`
>
> Automatically estimate real-world size; mutually exclusive with explicit sizing fields.
>
> **model\_url** `string`
>
> Model HTTP(S) URL or data URI to remesh. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **origin\_at** `string ("bottom" | "center")`
>
> Place the model origin at its bottom or center.
>
> **input\_task\_id** `string`
>
> Prior Meshy task ID containing the model to remesh. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **resize\_height** `number`
>
> Target height in meters; mutually exclusive with resize\_longest\_side and auto\_size.
>
> **target\_formats** `array`
>
> Formats for the remeshed output. Defaults to glb. Use CREATE\_CONVERT\_TASK when only format conversion is needed.
>
> **alpha\_thumbnail** `boolean`
>
> Generate a transparent-background preview thumbnail.
>
> **decimation\_mode** `integer ("1" | "2" | "3" | "4")`
>
> Decimation algorithm selector from 1 through 4.
>
> **target\_polycount** `integer`
>
> Target polygon count from 100 to 300000.
>
> **resize\_longest\_side** `number`
>
> Target longest side in meters; mutually exclusive with resize\_height and auto\_size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Resize Task
>
> **Slug:** `MESHY_CREATE_RESIZE_TASK`
>
> Start a 1-credit task that scales a model by height, longest side, or automatic sizing and return the task ID.
>
> #### Input Parameters
>
> **auto\_size** `boolean`
>
> Automatically estimate real-world size; choose exactly one sizing method.
>
> **model\_url** `string`
>
> Model HTTP(S) URL or data URI to resize. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **origin\_at** `string ("bottom" | "center")`
>
> Place the resized model origin at its bottom or center.
>
> **input\_task\_id** `string`
>
> Prior Meshy task ID containing the model to resize. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **resize\_height** `number`
>
> Target height in meters; choose exactly one sizing method.
>
> **resize\_longest\_side** `number`
>
> Target longest side in meters; choose exactly one sizing method.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Retexture Task
>
> **Slug:** `MESHY_CREATE_RETEXTURE_TASK`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name.
>
> **ai\_model** `string ("meshy-5" | "meshy-6" | "meshy-7" | "latest")`
>
> Meshy model to use.
>
> **art\_style** `string ("realistic" | "cartoon")`
>
> Art style to apply to the generated texture.
>
> **model\_url** `string`
>
> HTTP(S) URL or data URI for a GLB, GLTF, OBJ, FBX, or STL model. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **enable\_pbr** `boolean`
>
> Whether to produce PBR texture maps.
>
> **input\_task\_id** `string`
>
> Prior Meshy task containing the model to retexture. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **target\_formats** `array`
>
> Additional model formats to export.
>
> **alpha\_thumbnail** `boolean`
>
> Whether to produce a transparent-background preview thumbnail.
>
> **image\_style\_url** `string`
>
> HTTP(S) URL or data URI for one style reference image. Provide at least one style source. Takes precedence over text\_style\_prompt when both are provided; text\_style\_prompt is omitted from the request. Cannot be combined with multiview\_image\_urls.
>
> **remove\_lighting** `boolean`
>
> Whether to remove baked lighting from the texture; support depends on the selected model.
>
> **text\_style\_prompt** `string`
>
> Text description of the desired style. Provide at least one style source. May be combined with image\_style\_url, which takes precedence and causes text\_style\_prompt to be omitted from the request. Cannot be combined with multiview\_image\_urls.
>
> **enable\_original\_uv** `boolean`
>
> Whether to reuse the source model's UV coordinates.
>
> **texture\_resolution** `string ("2k" | "4k" | "8k")`
>
> Texture resolution tier. Meshy defaults to 2k when omitted; 8k consumes more credits.
>
> **multiview\_image\_urls** `array`
>
> One to four style reference views of the same object, primary view first. Requires ai\_model='meshy-7' and account entitlement; cannot be combined with text\_style\_prompt or image\_style\_url.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Rigging Task
>
> **Slug:** `MESHY_CREATE_RIGGING_TASK`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional task name.
>
> **model\_url** `string`
>
> HTTP(S) URL for the GLB model to rig. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **height\_meters** `number`
>
> Target character height in meters; must be greater than zero.
>
> **input\_task\_id** `string`
>
> Prior Meshy task containing the GLB model to rig. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **animation\_type** `string ("biped" | "quadruped")`
>
> Skeleton type to create for the character.
>
> **texture\_image\_url** `string`
>
> Optional PNG texture as an HTTP(S) URL or base64 data URI.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Text to 3D Task
>
> **Slug:** `MESHY_CREATE_TEXT_TO_3D_TASK`
>
> 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.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional human-readable task name.
>
> **seed** `integer`
>
> Non-negative random seed. Use 0 to let Meshy randomize it.
>
> **count** `integer`
>
> Number of candidates to generate, from 2 to 4. Not supported by meshy-t2 or fused generation.
>
> **prompt** `string` *required*
>
> Description of the object to generate.
>
> **ai\_model** `string ("meshy-5" | "meshy-6" | "meshy-7" | "latest" | "meshy-t2")`
>
> Meshy model to use; meshy-7 and meshy-t2 require entitlement.
>
> **model\_id** `string`
>
> Optional client-supplied identifier for batch correlation.
>
> **topology** `string ("quad" | "triangle")`
>
> Output mesh topology. quad is not supported by meshy-t2.
>
> **art\_style** `string`
>
> Art style for the generated model.
>
> **auto\_size** `boolean`
>
> Whether Meshy should estimate the model's real-world size.
>
> **origin\_at** `string ("bottom" | "center")`
>
> Place the generated model origin at its bottom or center.
>
> **pose\_mode** `string ("a-pose" | "t-pose")`
>
> Force an A-pose or T-pose for a character model.
>
> **enable\_pbr** `boolean`
>
> Whether to produce physically based rendering texture maps.
>
> **model\_type** `string ("standard" | "lowpoly" | "smart-topology")`
>
> Generation pipeline. smart-topology selects the meshy-t2 model family.
>
> **moderation** `boolean`
>
> Whether to run content moderation on this task.
>
> **ultra\_mode** `boolean`
>
> Enable the entitled high-detail pass for a meshy-7 preview; this consumes additional credits.
>
> **experimental** `object`
>
> Experimental fast-mode options that may change.
>
> **should\_remesh** `boolean`
>
> Whether to remesh after draft generation; the provider default depends on the model.
>
> **target\_formats** `array`
>
> Additional model formats to export.
>
> **texture\_prompt** `string`
>
> Description of the desired texture appearance.
>
> **alpha\_thumbnail** `boolean`
>
> Whether to produce a preview thumbnail with a transparent background.
>
> **decimation\_mode** `integer ("1" | "2" | "3" | "4")`
>
> Meshy decimation algorithm selector from 1 through 4.
>
> **generation\_path** `string ("preview" | "fused")` *required*
>
> Required generation path. preview creates geometry only and costs 20 credits for Meshy 6/7 or 5 for Meshy T2 and other models; fused creates geometry and texture in one task and costs 30 or 15 credits, respectively.
>
> **negative\_prompt** `string`
>
> Features or visual qualities that the generated object should avoid.
>
> **target\_polycount** `integer`
>
> Target polygon count from 100 to 300000; the provider chooses a model-specific default when omitted.
>
> **texture\_richness** `string ("none" | "low" | "medium" | "high")`
>
> Texture detail level.
>
> **texture\_image\_url** `string`
>
> HTTP(S) URL of an image to use as a texture reference.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Text to Image Task
>
> **Slug:** `MESHY_CREATE_TEXT_TO_IMAGE_TASK`
>
> 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.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Text description of the image to generate.
>
> **ai\_model** `string ("nano-banana" | "nano-banana-pro" | "nano-banana-2" | "gpt-image-2")` *required*
>
> Meshy image model to use.
>
> **pose\_mode** `string ("a-pose" | "t-pose")`
>
> Force an A-pose or T-pose; this may upgrade the model and require a higher account tier.
>
> **aspect\_ratio** `string ("1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3")`
>
> Output aspect ratio. gpt-image-2 supports 1:1, 16:9, 9:16, 3:2, and 2:3; nano-banana models support 1:1, 16:9, 9:16, 4:3, and 3:4. Do not set this for multi-view generation.
>
> **remove\_background** `boolean`
>
> Whether to return a transparent RGBA cutout. Available only for single-image generation.
>
> **generate\_multi\_view** `boolean`
>
> Whether to produce one four-view split image instead of a single image.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Text to Motion Task
>
> **Slug:** `MESHY_CREATE_TEXT_TO_MOTION_TASK`
>
> 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.
>
> #### Input Parameters
>
> **mode** `string ("prime" | "swift")`
>
> Generation mode: prime costs 10 credits and the completed task produces FBX; swift costs 3 credits and the completed task produces BVH.
>
> **prompt** `string` *required*
>
> Description of the motion to generate, up to 400 characters.
>
> **duration** `number` *required*
>
> Motion length from 2 to 10 seconds in 0.5-second increments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create UV Unwrap Task
>
> **Slug:** `MESHY_CREATE_UV_UNWRAP_TASK`
>
> 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.
>
> #### Input Parameters
>
> **model\_url** `string`
>
> GLB HTTP(S) URL or data URI. Required when input\_task\_id is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> **input\_task\_id** `string`
>
> Prior Meshy task containing the GLB model. Required when model\_url is omitted. When both sources are provided, input\_task\_id takes precedence and model\_url is omitted from the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task
>
> **Slug:** `MESHY_DELETE_TASK`
>
> Delete 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
>
> **task\_id** `string` *required*
>
> Provider task ID to permanently delete.
>
> **task\_type** `string ("text_to_3d" | "image_to_3d" | "multi_image_to_3d" | "retexture" | "remesh" | "convert" | "resize" | "uv_unwrap" | "rigging" | "animation" | "text_to_image" | "image_to_image" | "print_multi_color" | "print_repair" | "print_analyze" | "print_split" | "text_to_motion")` *required*
>
> Permanently deletable GA or Text-to-Motion task family that owns the ID; selects a fixed documented endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Balance
>
> **Slug:** `MESHY_GET_CREDIT_BALANCE`
>
> Return the connected Meshy account's available credit balance before starting paid generation tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task
>
> **Slug:** `MESHY_GET_TASK`
>
> Retrieve current status, errors, and available outputs for one task from a selected Meshy task family. This read does not consume credits.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Meshy task ID returned by a create or list call.
>
> **task\_type** `string` *required*
>
> Task family that owns the ID. This selects one fixed documented endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Animation Library
>
> **Slug:** `MESHY_LIST_ANIMATION_LIBRARY`
>
> Search or filter Meshy's unpaginated animation catalog and return action IDs for use when creating animation tasks.
>
> #### Input Parameters
>
> **search** `string`
>
> Literal case-insensitive substring to match against animation names or keys.
>
> **category** `string ("WalkAndRun" | "BodyMovements" | "DailyActions" | "Fighting" | "Dancing")`
>
> Exact animation category to return.
>
> **action\_ids** `array`
>
> One to 200 animation action IDs to return. Unknown IDs are omitted.
>
> **sub\_category** `string`
>
> Exact animation sub-category; the same name may occur in multiple categories.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tasks
>
> **Slug:** `MESHY_LIST_TASKS`
>
> Return 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
>
> **sort\_by** `string ("+created_at" | "-created_at")`
>
> Sort by creation time: +created\_at for oldest first or -created\_at for newest first.
>
> **page\_size** `integer`
>
> Tasks in this page. The maximum is 100 for 30 explicitly documented families. UV Unwrap, Rigging, Animation, and Text to Motion are capped at the documented and provider-accepted value 20; Text to Motion's exact provider maximum is not documented.
>
> **task\_type** `string`
>
> Exact Meshy task family to list. Required for the first page; omit it only when continuing with next\_cursor.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a prior call. When continuing, send next\_cursor as the only parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Usage Records
>
> **Slug:** `MESHY_LIST_USAGE_RECORDS`
>
> Return 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
>
> **status** `string ("SUCCEEDED" | "FAILED")`
>
> Terminal status to include: SUCCEEDED or FAILED. Omit to include both.
>
> **sort\_by** `string ("+created_at" | "-created_at")`
>
> Sort by creation time: +created\_at for oldest first or -created\_at for newest first.
>
> **end\_time** `string`
>
> End of the created\_at window as an RFC3339 timestamp. Defaults to the current time.
>
> **endpoints** `array`
>
> Endpoint families to include. Meshy receives these as one comma-separated endpoints filter; text-to-3d includes preview and refine.
>
> **page\_size** `integer`
>
> Usage records in this page, from 1 through 100.
>
> **start\_time** `string`
>
> Start of the created\_at window as an RFC3339 timestamp. Defaults to 30 days before end\_time.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a prior call. When continuing, send next\_cursor as the only parameter; the original filters are restored from it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Refine Text to 3D Task
>
> **Slug:** `MESHY_REFINE_TEXT_TO_3D_TASK`
>
> 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.
>
> #### Input Parameters
>
> **ai\_model** `string ("meshy-5" | "meshy-6" | "meshy-7" | "latest")`
>
> Texture model. Omit to inherit the preview task's model.
>
> **auto\_size** `boolean`
>
> Estimate the model's real-world height and resize it.
>
> **origin\_at** `string ("bottom" | "center")`
>
> Place the origin at the bottom or center when auto\_size is enabled.
>
> **enable\_pbr** `boolean`
>
> Generate metallic, roughness, and normal maps in addition to base color.
>
> **moderation** `boolean`
>
> Screen the texture prompt and reference image for harmful content.
>
> **target\_formats** `array`
>
> Model formats to generate for the textured output.
>
> **texture\_prompt** `string`
>
> Text guidance for the texture. If both texture guides are supplied, this takes precedence.
>
> **alpha\_thumbnail** `boolean`
>
> Also render a transparent-background preview thumbnail.
>
> **preview\_task\_id** `string` *required*
>
> ID of a succeeded Text to 3D preview task whose mesh will be textured.
>
> **remove\_lighting** `boolean`
>
> Remove highlights and shadows from base color; Meshy defaults this to true.
>
> **texture\_image\_url** `string`
>
> Public HTTP(S) URL or image data URI used to guide the texture.
>
> **texture\_resolution** `string ("2k" | "4k" | "8k")`
>
> Texture resolution. Meshy defaults to 2k; 2k/4k cost 10 credits and 8k costs 15 credits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
