3D Print

List Multi-Color Print tasks

get/v1/print/multi-color

Request

  • Base URL: https://api.meshy.ai/openapi
  • URL: https://api.meshy.ai/openapi/v1/print/multi-color
  • Auth: HTTP bearer

Query parameters

page_numinteger

Page number (1-based).

page_sizeinteger

Items per page (max 10).

sort_bystring

Sort key; a leading - sorts descending (e.g. -created_at). The sortable columns depend on the endpoint.

Response

A page of tasks, newest first by default.

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.