Multi-Image to 3D

Create a Multi-Image to 3D task

Provide 1-4 images of the same object via image_urls, or reuse a prior task's images via input_task_id. Only Meshy 5 and newer are supported. Consumes credits (varies by model and options); see https://docs.meshy.ai for pricing.

post/v1/multi-image-to-3d

Request

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

Request body

image_urlsstring[]

1-4 images of the same object.

input_task_idstring

Reuse images from a prior task.

namestring

Task name.

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

Model to use. Meshy 5 and newer only. latest resolves to meshy-7.1. meshy-7 is deprecated, superseded by meshy-7.1 (same parameters, same cost).

ultra_modeboolean nullable

Deprecated; equivalent to geometry_resolution: 2k.

geometry_resolution'standard' | '2k'

Geometry detail tier. 2k is equivalent to the deprecated ultra_mode: true and adds 5 credits (requires entitlement). Requires meshy-7.1 or latest.

topology'quad' | 'triangle'

Output mesh topology.

target_polycountinteger

Target polygon count.

should_remeshboolean nullable

Remesh after the draft stage. Default depends on model.

should_textureboolean

Run the texture stage.

enable_pbrboolean

Produce PBR texture maps.

texture_promptstring

Texture description. Mutually exclusive with texture_image_url(s).

texture_image_urlstring

Single texture reference. Mutually exclusive with texture_prompt and texture_image_urls.

texture_image_urlsstring[]

1-4 texture reference views (primary first). Requires should_texture and an effective Meshy 7 model. Mutually exclusive with texture_image_url/texture_prompt.

image_enhancementboolean nullable

Enhance the input images.

remove_lightingboolean nullable

Remove baked lighting.

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.

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.

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.