lowpoly retires Oct 30, 2026. 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, 2026To be announced
meshy-6ActiveN/AN/A
meshy-6-liteActiveN/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, 2026October 30, 2026
model_type: "lowpoly"DeprecatedJuly 13, 2026October 30, 2026

latest resolves to meshy-7.1.

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 3DOctober 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-7To be announcedmeshy-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