Retexture

Create a Retexture task

Provide exactly one of input_task_id or model_url (a GLB). Provide exactly one style source: text_style_prompt, image_style_url, or multiview_image_urls. Consumes credits (varies by model and resolution); see https://docs.meshy.ai for pricing.

post/v1/retexture

Request

  • Base URL: https://api.meshy.ai/openapi
  • URL: https://api.meshy.ai/openapi/v1/retexture
  • Auth: HTTP bearer

Request body

input_task_idstring

Prior task to retexture.

model_urlstring

GLB as an http(s) URL or data URI.

text_style_promptstring

Text style description. Mutually exclusive with multiview_image_urls.

image_style_urlstring

Style reference image. Mutually exclusive with multiview_image_urls.

multiview_image_urlsstring[]

1-4 views of the same object (primary first). Requires an explicit ai_model: meshy-7 (with entitlement). Mutually exclusive with the prompt/style-image inputs.

namestring

Task name.

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

Model to use.

art_style'realistic' | 'cartoon'

Art style.

enable_original_uvboolean

Reuse the source mesh UVs.

enable_pbrboolean

Produce PBR texture maps.

remove_lightingboolean nullable

Remove baked lighting (model-dependent support).

target_formatsstring[]

Additional export formats.

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

Texture resolution tier (defaults to 2k).

hd_textureboolean nullable

Deprecated; equivalent to texture_resolution: 4k.

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.