Text to 3D

Create a Text to 3D task

Creates a Text to 3D task. mode is required: use mode: preview to generate geometry, then mode: refine (with preview_task_id) to texture it. The 202 body is {"result": "<task id>"}. Consumes credits (varies by model and options); see https://docs.meshy.ai for pricing.

post/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

Request body

mode'preview' | 'refine' required

Phase. preview generates geometry; refine textures a preview.

promptstring

Text description of the object. Required for preview / fused tasks.

negative_promptstring

What to avoid.

texture_promptstring

Texture description.

texture_image_urlstring

Texture reference image URL.

namestring

Task name.

preview_task_idstring

Parent preview task ID. Required when mode=refine.

art_style'realistic'

Art style.

texture_richness'none' | 'low' | 'medium' | 'high'

Texture detail level.

ai_model'meshy-6' | 'meshy-6-lite' | 'meshy-7' | 'meshy-7.1' | 'latest' | 'meshy-t2'

Model to use. latest resolves server-side to meshy-7.1. meshy-7, meshy-7.1, and meshy-t2 require account entitlement. meshy-7 is deprecated, superseded by meshy-7.1 (same parameters, same cost). The aliases meshy-standard-latest and meshy-smart-topology-latest are also accepted and normalized server-side. The latest default applies to mode: preview and to fused single-call tasks; on mode: refine, omitting this inherits the preview task's model instead.

model_type'standard' | 'lowpoly' | 'smart-topology'

Pipeline. smart-topology implies the meshy-t2 model family. lowpoly is deprecated and will be retired on 2026-10-30; after that date it returns an error. Use smart-topology (Meshy T2) instead.

topology'quad' | 'triangle'

Output mesh topology. quad is not supported for meshy-t2.

target_polycountinteger nullable

Target polygon count. Defaults to 30000 (meshy-t2 uses a smaller model-specific default).

should_remeshboolean nullable

Remesh after the draft stage. Default depends on model.

should_textureboolean nullable

Not generally available yet: ignored unless the one-call textured path is enabled for your account. Use mode: preview, then mode: refine.

enable_pbrboolean

Produce PBR texture maps.

moderationboolean

Run content moderation.

pose_mode'a-pose' | 't-pose'

Force a rest pose for characters.

symmetry_mode'off' | 'auto' | 'on'

Deprecated; has no effect.

is_a_t_poseboolean

Deprecated; use pose_mode.

seedinteger

RNG seed; randomized when 0.

origin_at'bottom' | 'center'

Where to place the model origin.

decimation_mode1 | 2 | 3 | 4

Decimation algorithm selector.

countinteger

Number of candidates to generate. Not supported for meshy-t2 or fused tasks.

model_idstring

Optional client-supplied identifier for batch requests.

target_formatsstring[]

Additional export formats.

texture_resolution'2k' | '4k' | '8k' nullable

Texture resolution tier. Only valid when mode=refine.

hd_textureboolean nullable

Deprecated; equivalent to texture_resolution: 4k.

ultra_modeboolean nullable

Deprecated; equivalent to geometry_resolution: 2k.

geometry_resolution'standard' | '2k' | '4k'

Geometry detail tier, preview stage only. 2k is equivalent to the deprecated ultra_mode: true. Requires meshy-7.1 or latest. Either Ultra tier adds 5 credits and requires account entitlement.

remove_lightingboolean nullable

Remove baked lighting from textures.

auto_sizeboolean

Auto-estimate real-world size.

alpha_thumbnailboolean

Opt in to a transparent-background preview.

Response

Task accepted for processing.

resultstring required

The created task's ID.

Changes

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