lowpoly retires Oct 30, 2026. meshy-7 for 3D generation retires Dec 31, 2026; as a texture model it stays available. Please switch models before these dates to avoid request errors. See all deprecations

Deprecations

See which Meshy AI models and API features are active, deprecated, or retired, and find retirement dates and recommended replacements.

As Meshy releases new models, it retires older ones. Integrations that rely on an older model or API feature may need occasional updates to keep working. This page lists every API deprecation, along with its recommended replacement.


Overview

Meshy uses these terms to describe the lifecycle of a model or API feature:

  • Active: Fully supported and recommended for use.
  • Legacy: No longer receives updates and may be deprecated in the future. It still works, and nothing about your request or your bill changes.
  • Deprecated: Still works, but no longer recommended. Meshy names a recommended replacement and, once it is scheduled, a retirement date.
  • Retired: No longer available. Requests that use a retired model or feature return an error.

Retiring a model doesn't delete what you already made with it. Tasks you created with a retired model stay available for the usual retention period.


Migrating to Replacements

Once a model is deprecated, move all your requests to its replacement before the retirement date. Requests that use the model after that date fail.

A replacement can produce different results from the model it replaces. Test your integration with the replacement well before the retirement date, for example in the Playground.


Notifications

Meshy announces every deprecation and retirement in the Changelog and on this page. While a retirement is upcoming, a banner at the top of every API page shows it, and the endpoint pages mark the model or parameter as deprecated.

Meshy announces a retirement date at least one month before the retirement.


Best Practices

  1. Check the Changelog and this page regularly for deprecation updates.
  2. Set ai_model to a specific model, such as meshy-7.1, if your integration needs consistent output. latest always points to the newest standard model, so its output changes when a new model is released.
  3. Test your integration with the replacement well before the retirement date of your current model.
  4. Update your code to use the recommended replacement as soon as possible.
  5. Contact support@meshy.ai if you need help with a migration.

Model Status

Current and retired 3D generation models of Text to 3D, Image to 3D, Multi-Image to 3D, and Retexture. Not every endpoint offers every model; each endpoint page lists the models it accepts.

API model nameCurrent stateDeprecatedRetirement date
meshy-7.1ActiveN/AN/A
meshy-7DeprecatedSeptember 18, 2026December 31, 2026 (geometry); N/A (texture)
meshy-6ActiveN/AN/A
meshy-6-liteActiveN/AN/A
meshy-n1ActiveN/AN/A
meshy-5RetiredSeptember 11, 2026October 10, 2026
meshy-4RetiredN/AMarch 20, 2026
meshy-3RetiredJanuary 14, 2025July 2025
meshy-t2.5ActiveN/AN/A
meshy-t2ActiveN/AN/A
meshy-t1DeprecatedJuly 13, 2026November 30, 2026
model_type: "lowpoly"DeprecatedJuly 13, 2026November 30, 2026

latest resolves to meshy-7.1.

The meshy-7 retirement covers it as the ai_model of Text to 3D preview tasks, Image to 3D, and Multi-Image to 3D. meshy-7.1 takes the same parameters and costs the same. From December 31, 2026, those requests return 400.

meshy-7 as a texture model is not affected. That covers Retexture, texture_model, and the ai_model of a Text to 3D refine, which picks only the texture model.

Until November 30, 2026, these requests still run on a Smart Topology model with triangle topology and cost the Smart Topology price:

  • Image to 3D with model_type: "smart-topology" and ai_model: "meshy-t1", or with model_type: "lowpoly" and ai_model left out, latest, or meshy-6. Meshy ignores target_polycount, topology, image_enhancement, remove_lighting, and experimental on them.
  • A Text to 3D preview with model_type: "lowpoly" and ai_model left out, latest, meshy-6, or meshy-4 (otherwise retired, meshy-4 is accepted here only for this fallback). Meshy ignores target_polycount, topology, and experimental on it.

Every other request for meshy-t1 or lowpoly already returns 400. From November 30, 2026, these return 400 too.


Deprecation History

All deprecations are listed below, with the most recent announcements first.

AnnouncedDeprecated model or featureRetirement dateRecommended replacement
2026-10-02model_type: "lowpoly" and meshy-t1 on Text to 3D and Image to 3DNovember 30, 2026model_type: "smart-topology" with ai_model: "meshy-t2.5"
2026-09-29/v2/text-to-3d without the /openapi prefixTo be announced/openapi/v2/text-to-3d
2026-09-18meshy-7 as the ai_model of Text to 3D preview, Image to 3D, and Multi-Image to 3DDecember 31, 2026meshy-7.1
2026-09-16Shared test-mode API keySeptember 16, 2026Your own key from the API Keys page, or the Playground
2026-09-11meshy-5October 10, 2026meshy-6-lite
2026-03-20meshy-4March 20, 2026meshy-6
2025-10-01Text to Voxel APIOctober 1, 2025None
2025-07-01Text to Texture APIJuly 1, 2025Retexture
2025-01-14meshy-3July 2025meshy-6

API Parameter Deprecations

Meshy occasionally deprecates request parameters and response fields that newer models replace or no longer use. They still work unless noted, but a future release can remove them.

ParameterStatusBehaviorRecommended replacement
texture_image_url on RiggingDeprecated October 23, 2026Still works. The image becomes the rigged model's only texture, and the model loses its PBR maps.Omit it. Meshy uses the textures of model_url or of the input task.
ultra_modeDeprecated September 18, 2026ultra_mode: true is the same as geometry_resolution: "2k".geometry_resolution
hd_textureDeprecated July 21, 2026hd_texture: true is the same as texture_resolution: "4k". If you send both, Meshy uses texture_resolution.texture_resolution
Convert and resize parameters of RemeshDeprecated May 22, 2026Still work.Convert and Resize
symmetry_modeDeprecated May 11, 2026Accepted and ignored.Omit it.
art_style on Text to 3D PreviewDeprecated January 22, 2026Accepted and ignored. It applied only to Meshy 4 and Meshy 5.Omit it.
is_a_t_poseDeprecated December 4, 2025Still works.pose_mode