Repair Printability API

Required unless you send model_url. The ID of the task whose model you want to repair, for example an Image to 3D, Multi-Image to 3D, Text to 3D, Remesh, Retexture, or Analyze Printability task. The task must be one you created with the API, with the status SUCCEEDED and a GLB model.

An Analyze Printability task that checked wall thickness also passes on its printer and size. The repair then checks wall thickness and thickens thin walls, even if you send neither. A printer_type or print size you send replaces the one from the analysis. An Analyze Printability task of an .stl, .fbx, or .gltf file from model_url doesn't work. Send that file as model_url instead.

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

From an http or https URL, the model must be a .glb, .gltf, .obj, .fbx, or .stl file of at most 400 MB. A data URI can hold only a base64 GLB (data:model/gltf-binary;base64,...) or glTF (data:model/gltf+json;base64,...) file of at most 100 MB. Send an .obj, .fbx, or .stl file as an http or https URL.

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.

A Meshy download URL (assets.meshy.ai/…?Expires=…&Signature=…) is signed and stops working at its task's expires_at. Reading the task again doesn't renew it. For a model you made with Meshy, send input_task_id instead, which works while Meshy keeps the source task (see Asset retention). To use the model after that, download it before expires_at and send your own copy.

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 printer you plan to use. It sets the minimum wall thickness the repair aims for. If you send a print size without printer_type, Meshy uses fdm, unless an Analyze Printability task in input_task_id supplies the printer.

Available values:

• fdm: filament, 1.0 mm minimum wall
• sla: resin, 0.8 mm minimum wall
• full_color: full-color, 2.0 mm minimum wall

Any other value returns 400.

The height of the print, in millimeters, from 1 to 1000. A value outside the range returns 400. Send this or intended_print_longest_side_mm, not both.

It works only with GLB input. For a model_url that isn't a .glb file, send intended_print_longest_side_mm instead.

The length of the print's longest side, in millimeters, from 1 to 1000. A value outside the range returns 400. It works with every input format.

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

• Missing parameter: Neither input_task_id nor model_url was sent.
• Invalid UUID: input_task_id isn't a valid UUID.
• Invalid model URL: model_url is malformed, uses an unsupported scheme, or has an unsupported file extension.
• 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 a GLB, glTF, FBX, or OBJ file over 100 MB with 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.
• Model file can't be downloaded: model_url returned an error, most often because a signed Meshy download URL expired. Reading the task again returns the same URL with the same expiry. Send your own copy of the file, or send input_task_id while Meshy keeps the source task.
• Task not succeeded: The input_task_id task is still pending, in progress, or failed.
• Missing GLB: The input_task_id task has no GLB model to repair.
• Invalid print size: intended_print_height_mm or intended_print_longest_side_mm is outside 1 to 1000, or the request has both.
• Unknown printer type: printer_type isn't fdm, sla, or full_color.
• Height on a non-GLB model: The request has intended_print_height_mm and a model_url that isn't a .glb file. Send intended_print_longest_side_mm instead.
• Can't size this model by height: At the requested height, or the default 150 mm, the model's longest side would be outside 1 to 1,000 mm. It also happens when the model is flat, or when Meshy can't determine its size. Send intended_print_longest_side_mm instead. For a .glb model_url and some input_task_id tasks, Meshy finds this only after the task starts, and the task ends as FAILED instead.
• STL size unusable: The request has printer_type without a size, and Meshy can't read the .stl file's own longest side, or it's outside 1 to 1,000 mm. Send intended_print_longest_side_mm.

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 repair. The message is This model type does not support this operation. Send a different model.

The input_task_id task doesn't exist or belongs to another user. Check the ID, and use an API key from the account that created the task.

You exceeded your rate limit, or you have too many pending tasks. 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, starting at 1.

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 print-repair.

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

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

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.

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

The error details when the task fails. It's null if the task hasn't failed. See Errors.

Download URLs for the repaired model. It has only the key that matches the input format. A format the task didn't generate has no key, rather than an empty string.

Download URL for a preview image of the repaired 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.

Always an empty array. Repair keeps only the input geometry and doesn't re-bake textures.

The number of credits the task used. It's 10 when the task is SUCCEEDED, and 0 for a FAILED task, because Meshy refunds the credits when a task fails.

The printer and size the repair used, whether you sent them or Meshy reused them from an Analyze Printability task. Present on a wall-thickness repair from the start, including while the task is PENDING. A value Meshy doesn't know yet is null.

What the wall-thickness repair did. Present after a wall-thickness repair succeeds.