lowpoly será descontinuado em 30 de out. de 2026. meshy-7 como modelo de geração 3D será descontinuado em 31 de dez. de 2026; como modelo de textura continua disponível. Troque de modelo antes dessas datas para evitar erros nas solicitações. Ver todas as descontinuações

Obsolescências

Veja quais modelos de IA da Meshy e recursos da API estão ativos, obsoletos ou retirados, e encontre datas de retirada e substitutos recomendados.

À medida que a Meshy lança novos modelos, ela retira os mais antigos. Integrações que dependem de um modelo ou recurso de API mais antigo podem precisar de atualizações ocasionais para continuar funcionando. Esta página lista todas as obsolescências da API, junto com seu substituto recomendado.


Visão geral

A Meshy usa estes termos para descrever o ciclo de vida de um modelo ou recurso de API:

  • Ativo: Totalmente suportado e recomendado para uso.
  • Legacy: Não recebe mais atualizações e pode se tornar obsoleto no futuro. Ainda funciona, e nada muda em relação à sua requisição ou à sua cobrança.
  • Obsoleto: Ainda funciona, mas não é mais recomendado. A Meshy indica um substituto recomendado e, assim que for agendada, uma data de retirada.
  • Retirado: Não está mais disponível. Requisições que usam um modelo ou recurso retirado retornam um erro.

Retirar um modelo não exclui o que você já criou com ele. As tarefas criadas com um modelo retirado permanecem disponíveis pelo período de retenção usual.


Migrando para substitutos

Assim que um modelo se tornar obsoleto, migre todas as suas requisições para o substituto dele antes da data de retirada. Requisições que usam o modelo após essa data falham.

Um substituto pode produzir resultados diferentes do modelo que ele substitui. Teste sua integração com o substituto bem antes da data de retirada, por exemplo no Playground.


Notificações

A Meshy anuncia toda obsolescência e retirada no registro de alterações e nesta página. Enquanto uma retirada estiver próxima, um banner no topo de todas as páginas da API a exibe, e as páginas de endpoint marcam o modelo ou parâmetro como obsoleto.

A Meshy anuncia uma data de retirada com pelo menos um mês de antecedência.


Boas práticas

  1. Verifique o registro de alterações e esta página regularmente para atualizações de obsolescência.
  2. Defina ai_model para um modelo específico, como meshy-7.1, se sua integração precisar de resultados consistentes. latest sempre aponta para o modelo padrão mais recente, então seu resultado muda quando um novo modelo é lançado.
  3. Teste sua integração com o substituto bem antes da data de retirada do seu modelo atual.
  4. Atualize seu código para usar o substituto recomendado o quanto antes.
  5. Entre em contato com support@meshy.ai se precisar de ajuda com uma migração.

Status do modelo

Modelos de geração 3D atuais e retirados de Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar. Nem todo endpoint oferece todos os modelos; cada página de endpoint lista os modelos que aceita.

Nome do modelo na APIEstado atualObsoletoData de retirada
meshy-7.1AtivoN/AN/A
meshy-7Obsoleto18 de setembro de 202631 de dezembro de 2026 (geometria); N/A (textura)
meshy-6AtivoN/AN/A
meshy-6-liteAtivoN/AN/A
meshy-n1AtivoN/AN/A
meshy-5Retirado11 de setembro de 202610 de outubro de 2026
meshy-4RetiradoN/A20 de março de 2026
meshy-3Retirado14 de janeiro de 2025julho de 2025
meshy-t2.5AtivoN/AN/A
meshy-t2AtivoN/AN/A
meshy-t1Obsoleto13 de julho de 202630 de novembro de 2026
model_type: "lowpoly"Obsoleto13 de julho de 202630 de novembro de 2026

latest é resolvido para meshy-7.1.

A retirada do meshy-7 o cobre como o ai_model das tarefas de preview de Texto para 3D, Imagem para 3D e Multi-imagem para 3D. O meshy-7.1 aceita os mesmos parâmetros e custa o mesmo. A partir de 31 de dezembro de 2026, essas requisições retornam 400.

O meshy-7 como modelo de textura não é afetado. Isso cobre Retexturizar, texture_model, e o ai_model de um refine de Texto para 3D, que seleciona apenas o modelo de textura.

Até 30 de novembro de 2026, estas requisições ainda rodam em um modelo Smart Topology com topology triangular e custam o preço do Smart Topology:

  • Imagem para 3D com model_type: "smart-topology" e ai_model: "meshy-t1", ou com model_type: "lowpoly" e ai_model omitido, latest, ou meshy-6. A Meshy ignora target_polycount, topology, image_enhancement, remove_lighting e experimental nelas.
  • Um preview de Texto para 3D com model_type: "lowpoly" e ai_model omitido, latest, meshy-6, ou meshy-4 (que, embora retirado, é aceito aqui apenas para este fallback). A Meshy ignora target_polycount, topology e experimental nele.

Toda outra requisição para meshy-t1 ou lowpoly já retorna 400. A partir de 30 de novembro de 2026, estas também retornarão 400.


Histórico de obsolescência

Todas as obsolescências estão listadas abaixo, com os anúncios mais recentes primeiro.

AnunciadoModelo ou recurso obsoletoData de retiradaSubstituto recomendado
2026-10-02model_type: "lowpoly" e meshy-t1 em Texto para 3D e Imagem para 3D30 de novembro de 2026model_type: "smart-topology" com ai_model: "meshy-t2.5"
2026-09-29/v2/text-to-3d sem o prefixo /openapiA ser anunciado/openapi/v2/text-to-3d
2026-09-18meshy-7 como o ai_model do preview de Texto para 3D, Imagem para 3D e Multi-imagem para 3D31 de dezembro de 2026meshy-7.1
2026-09-16Chave de API compartilhada em modo de teste16 de setembro de 2026Sua própria chave na página de chaves de API, ou o Playground
2026-09-11meshy-510 de outubro de 2026meshy-6-lite
2026-03-20meshy-420 de março de 2026meshy-6
2025-10-01API de Texto para Voxel1 de outubro de 2025Nenhum
2025-07-01API de Texto para textura1 de julho de 2025Retexturizar
2025-01-14meshy-3julho de 2025meshy-6

Obsolescências de parâmetros da API

A Meshy ocasionalmente torna obsoletos parâmetros de requisição e campos de resposta que modelos mais recentes substituem ou não usam mais. Eles ainda funcionam, salvo indicação contrária, mas um lançamento futuro pode removê-los.

ParâmetroStatusComportamentoSubstituto recomendado
texture_image_url em RiggingObsoleto desde 23 de outubro de 2026Ainda funciona. A imagem se torna a única textura do modelo com rig, e o modelo perde seus mapas PBR.Omita-o. A Meshy usa as texturas do model_url ou da tarefa de entrada.
ultra_modeObsoleto desde 18 de setembro de 2026ultra_mode: true é o mesmo que geometry_resolution: "2k".geometry_resolution
hd_textureObsoleto desde 21 de julho de 2026hd_texture: true é o mesmo que texture_resolution: "4k". Se você enviar ambos, a Meshy usa texture_resolution.texture_resolution
Parâmetros de conversão e redimensionamento do RemeshObsoleto desde 22 de maio de 2026Ainda funcionam.Converter e Redimensionar
symmetry_modeObsoleto desde 11 de maio de 2026Aceito e ignorado.Omita-o.
art_style no Preview de Texto para 3DObsoleto desde 22 de janeiro de 2026Aceito e ignorado. Aplicava-se apenas ao Meshy 4 e ao Meshy 5.Omita-o.
is_a_t_poseObsoleto desde 4 de dezembro de 2025Ainda funciona.pose_mode