Mesh Repair

Mesh repair API reference. Fix non-manifold geometry, hollow models, set wall thickness, scale to exact dimensions. Print-ready 3D model preparation via REST API.

Repair Mesh

POST

/v1/tools/repair/

Fix common mesh problems and prepare models for 3D printing or production use. The tool automatically repairs issues like duplicate vertices, inconsistent normals, and loose geometry, then performs a clean remesh to produce a watertight mesh. You can optionally hollow the model to reduce 3D printing material costs, scale it to a specific height, bake textures onto the new mesh, and choose between triangle or quad topology. Input supports GLB, OBJ, STL, PLY, FBX, and ZIP. Costs 60 credits (90 with hollowing enabled).

Request

curl -X POST https://api.3daistudio.com/v1/tools/repair/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/model.glb",
    "output_format": "stl",
    "hollow": true,
    "wall_thickness": 2.0,
    "target_height": 15.0,
    "unit": "cm",
    "quality": "default"
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

What Gets Repaired

The tool automatically detects and fixes common mesh problems including broken geometry, inconsistent surfaces, and disconnected elements. The output is a clean, watertight mesh ready for 3D printing or production use.

Remesh Quality

The quality parameter controls the density of the remeshed output. Higher quality preserves more detail but produces more polygons.

Quality	Detail Level	Best For
low	Lower polygon count, smoother surface	Quick previews, low poly assets, small prints
default	Balanced detail and polygon count	Most use cases, standard 3D printing
max	Highest detail preservation	Large prints, detailed models, production assets

Hollowing

When hollow is enabled, the tool creates an inner shell inside the model at the specified wall thickness, producing a hollow interior. This significantly reduces material usage for 3D printing. The wall thickness must be less than half the smallest dimension of the model. The inner shell is smoothed to prevent artifacts.

Parameters

Parameter	Type	Required	Description
model_url	string (URL)	Yes	URL of the 3D model. Supports GLB, OBJ, STL, PLY, FBX, and ZIP.
output_format	string	No	"glb", "obj", "obj_zip", "stl", "ply", or "fbx". Default: "glb". OBJ and STL outputs are automatically scaled to millimeters.
hollow	boolean	No	Hollow the model for 3D printing. Default: false. Adds 30 credits.
wall_thickness	number	No	Wall thickness when hollowing. Must be greater than 0 and less than half the model's smallest dimension. Default: 2.0.
target_height	number	No	Scale the model so its tallest dimension matches this value. Must be greater than 0.
unit	string	No	Unit for wall_thickness and target_height: "cm", "mm", or "inches". Default: "cm".
topology	string	No	Output mesh topology: "tris" (triangles) or "quads" (quadrilaterals). Default: "tris".
quality	string	No	Remesh quality: "low", "default", or "max". Default: "default". See quality table above.
texture_resolution	integer	No	Resolution for baked textures: 1024, 2048, 4096, or 8192. Default: 4096.
bake_textures	boolean	No	Bake the original textures onto the remeshed model using UV projection. Default: true.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains the repaired model file. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": null,
      "asset": "https://storage.3daistudio.com/assets/repaired_model.stl",
      "asset_type": "3D_MODEL",
      "thumbnail": null
    }
  ]
}

Credit Costs

Option	Credits
Standard repair and remesh	60
With hollowing enabled	90

Processing Times

Processing typically takes 35–80 seconds. Simple repairs are faster, while enabling hollowing or high-quality remeshing takes longer. Very large or complex meshes may take up to 2 minutes.