3D Print

Retrieve an Auto Split task

get/v1/print/split/{id}

Request

  • Base URL: https://api.meshy.ai/openapi
  • URL: https://api.meshy.ai/openapi/v1/print/split/{id}
  • Auth: HTTP bearer

Response

The task. On success, model_urls holds one URL per requested format, part_count the number of printable parts. Auto Split tasks omit the generation-prompt fields, model_url and texture_urls, which they never populate.

idstring required
typestring

Task type.

namestring
art_stylestring
object_promptstring
style_promptstring
negative_promptstring
texture_promptstring
texture_image_urlstring
text_style_promptstring
image_style_urlstring
multiview_image_urlsstring[]
texture_image_urlsstring[]
status'PENDING' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' required

Task lifecycle status.

created_atinteger required

Creation time (epoch ms).

progressinteger required
preceding_tasksinteger

Queue position while pending.

started_atinteger

Start time (epoch ms; 0 if not started).

finished_atinteger

Finish time (epoch ms; 0 if not finished).

expires_atinteger

Asset download deadline (epoch ms).

model_urlstring

Deprecated; use model_urls.

thumbnail_urlstring
alpha_thumbnail_urlstring

Transparent-background preview (when opted in).

thumbnail_urlsobject

Cardinal-view thumbnails (image-to-3d only).

remove_lightingboolean nullable
ultra_modeboolean nullable

Deprecated; read geometry_resolution instead.

geometry_resolutionstring

Echoed Ultra tier (2k or 4k); omitted when the task did not run an Ultra tier.

hd_textureboolean nullable

Deprecated; see texture_resolution.

texture_resolutionstring

Texture tier (e.g. 4k, 8k).

consumed_creditsinteger nullable

Credits consumed.

prompt_ignoredboolean

True when a by_parts / by_color print/split prompt named no parts and Meshy split the model automatically instead; present from PENDING on. Omitted for auto tasks, when the prompt was followed, and for other task types.

part_countinteger

Number of printable parts a print/split produced; formats that support scene objects carry one object per part, stl fuses them into one solid. Degenerate slivers are removed before export and not counted. Omitted for other task types.

Changes

No recorded changes to this operation across all 1 revision of this API.