Text to 3D

List Text to 3D tasks

get/v2/text-to-3d

Request

  • Base URL: https://api.meshy.ai/openapi
  • URL: https://api.meshy.ai/openapi/v2/text-to-3d
  • 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
modestring

Legacy preview/refine phase; omitted for one-call fused tasks.

namestring
model_typestring
seedinteger
art_stylestring
texture_richnessstring
promptstring
negative_promptstring
texture_promptstring
texture_image_urlstring
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
finished_atinteger
thumbnail_urlstring
alpha_thumbnail_urlstring
video_urlstring

Deprecated.

remove_lightingboolean nullable
hd_textureboolean nullable
texture_resolutionstring
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.

consumed_creditsinteger nullable

Changes

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