Image to 3D

Create an Image to 3D task

Provide exactly one of image_url or input_task_id. Consumes credits (varies by model and options); see https://docs.meshy.ai for pricing.

post/v1/image-to-3d

Request

  • Base URL: https://api.meshy.ai/openapi
  • URL: https://api.meshy.ai/openapi/v1/image-to-3d
  • Auth: HTTP bearer

Request body

image_urlstring

Input image as an http(s) URL or a data URI.

input_task_idstring

Reuse the input image from a prior task.

namestring

Task name.

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

Model to use. latest resolves to meshy-7.1. meshy-t2 requires model_type: smart-topology. meshy-7 and meshy-7.1 require account entitlement. meshy-7 is deprecated, superseded by meshy-7.1 (same parameters, same cost).

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

Pipeline selector. 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 default).

should_remeshboolean nullable

Remesh after the draft stage. Default depends on model.

should_textureboolean

Run the texture stage.

enable_pbrboolean

Produce PBR texture maps.

ultra_modeboolean nullable

Deprecated; equivalent to geometry_resolution: 2k.

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

Geometry detail tier. 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.

texture_promptstring

Texture description.

texture_image_urlstring

Texture reference image URL.

image_enhancementboolean nullable

Enhance the input image. Not supported under smart-topology.

remove_lightingboolean nullable

Remove baked lighting. Not supported under smart-topology.

moderationboolean

Run content moderation.

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

Force a rest pose for characters.

surface_mode'organic' | 'hard'

Deprecated; use ai_model.

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

Deprecated; has no effect.

is_a_t_poseboolean

Deprecated; use pose_mode.

save_pre_remeshed_modelboolean

Also return the pre-remesh model.

auto_sizeboolean

Auto-estimate real-world size.

origin_at'bottom' | 'center'

Where to place the model origin.

decimation_mode1 | 2 | 3 | 4

Decimation algorithm selector.

target_formatsstring[]

Additional export formats.

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

Texture resolution tier.

hd_textureboolean nullable

Deprecated; equivalent to texture_resolution: 4k.

multi_view_thumbnailsboolean

Render front/right/back/left thumbnails (single image only).

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.