Remesh API

Required unless you send model_url. The ID of the task whose model you want to remesh, for example a Text to 3D, Image to 3D, Retexture, or Remesh task. The task must be one you created with the API and have the status SUCCEEDED.

Required unless you send input_task_id. The model to remesh, as a public URL or a data URI. If you send both, Meshy uses input_task_id.

The model must be a GLB, glTF, OBJ, FBX, or STL file of at most 400 MB from an http or https URL, or 100 MB as a data URI. For a data URI, use the MIME type application/octet-stream.

A file over 100 MB must also follow these rules:

• A GLB, glTF, FBX, or OBJ file can have at most 10,000,000 faces. Meshy counts faces as triangles, so a quad counts as 2, and a mesh drawn more than once counts once per copy.
• An FBX file must be binary FBX 7.1 or newer.
• A GLB or glTF file must not use Draco compression.

The file formats to generate.

Available values:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

The face type of the remeshed model.

Available values:

• quad: a quad-dominant mesh
• triangle: a decimated triangle mesh

The number of faces to aim for, from 100 to 300000. The result can differ from the target, depending on the model's geometry. A value outside the range returns 400.

Adaptive face count, by level. When you set it, Meshy ignores target_polycount.

Available values:

• 1: ultra
• 2: high
• 3: medium
• 4: low

Use the Resize API instead. The height to resize the model to, in meters. Send at most one of resize_height, resize_longest_side, and auto_size.

Use the Resize API instead. The length to resize the longest side of the model's bounding box to, in meters. Send at most one of resize_height, resize_longest_side, and auto_size.

Use the Resize API instead. Whether to estimate the object's real-world height with AI vision and resize the model to it. Send at most one of resize_height, resize_longest_side, and auto_size.

Use the Resize API instead. Where to put the model's origin, bottom or center. The default applies when you send resize_height, resize_longest_side, or auto_size. Without one of them, Meshy moves the origin only if you send origin_at.

Use the Convert API instead. Whether to only convert the model to target_formats. When true, Meshy ignores topology, target_polycount, decimation_mode, resize_height, resize_longest_side, and auto_size, but still checks their values, so an invalid value returns 400. With convert_format_only: true, an empty or null target_formats returns 400.

Whether to also render a preview with a transparent background (RGBA), returned in alpha_thumbnail_url when you get the task. thumbnail_url doesn't change.

The request can't run. The error message says which problem it found. For example:

• Missing parameter: Neither model_url nor input_task_id was sent.
• Invalid input task: input_task_id isn't a successful API task, or its AI model doesn't support remeshing.
• Invalid model format: The model_url file has an unsupported extension.
• Unreachable URL: Meshy can't download the model_url file.
• Model file too large: The model_url file is over 400 MB from an http or https URL, or over 100 MB as a data URI.
• Too many faces: The model_url file is over 100 MB and has more than 10,000,000 faces. Reduce the face count, then send the file again.
• ASCII FBX over 100 MB: The model_url file is an ASCII FBX over 100 MB. Send it as binary FBX or GLB.
• Unreadable model file: The model_url file is over 100 MB, and Meshy can't read its header. For example, it's a Draco-compressed GLB or glTF, or a binary FBX older than 7.1.
• Model header too complex: The model_url file is over 100 MB, and its header has too many meshes, nodes, or records to check. Reduce the number of objects in the file, then send it again.
• Invalid topology: topology isn't quad or triangle.
• Mutually exclusive parameters: The request has more than one of auto_size, resize_height, and resize_longest_side. Send only one.

Fix the request, then send it again. See Errors.

The API key is missing or invalid. Check the Authorization header.

For example:

• Insufficient credits: The account doesn't have enough credits for this task, or the account reached a credit limit. Check your credit balance, then retry.
• Free plan: Creating a task requires a paid plan. Upgrade your plan in your subscription settings, then retry.

input_task_id is a bas-relief model, which this endpoint can't remesh. The message is This model type does not support this operation. Send a different model.

input_task_id doesn't match any of your tasks. Check the task ID, then send the request again.

You exceeded your rate limit. Wait, then retry. See Rate limits.

The task ID from the create response.

The ID of the task to delete.

The page number to return.

The number of tasks per page, up to 100.

The sort order.

Available values:

• +created_at: oldest first
• -created_at: newest first

The task ID from the create response.

The task ID. Treat it as an opaque string, and don't rely on its format.

The task type, always remesh.

Download URLs for the remeshed model, one per file format. A format the task didn't generate has no key, rather than an empty string.

Download URL for a preview image of the remeshed model.

Download URL for a version of thumbnail_url with a transparent background (RGBA). Present only when you created the task with alpha_thumbnail: true and Meshy rendered the transparent preview.

How much of the task is done, as a percentage. It's 0 until the task starts and 100 when it succeeds.

The task status, one of PENDING, IN_PROGRESS, SUCCEEDED, or FAILED.

The number of tasks ahead of this one in the queue. The value is meaningful only while the task is PENDING.

Time the task was created, in Unix milliseconds.

Time the task started, in Unix milliseconds. It's 0 until the task starts.

Time the task finished, in Unix milliseconds. It's 0 until the task finishes.

The error details when the task fails. See Errors.

The number of credits the task used. Present when the status is PENDING, IN_PROGRESS, or SUCCEEDED. It's 0 for a FAILED task, because Meshy refunds the credits when a task fails.