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
- Verifique o registro de alterações e esta página regularmente para atualizações de obsolescência.
- Defina
ai_modelpara um modelo específico, comomeshy-7.1, se sua integração precisar de resultados consistentes.latestsempre aponta para o modelo padrão mais recente, então seu resultado muda quando um novo modelo é lançado. - Teste sua integração com o substituto bem antes da data de retirada do seu modelo atual.
- Atualize seu código para usar o substituto recomendado o quanto antes.
- 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 API | Estado atual | Obsoleto | Data de retirada |
|---|---|---|---|
meshy-7.1 | Ativo | N/A | N/A |
meshy-7 | Obsoleto | 18 de setembro de 2026 | 31 de dezembro de 2026 (geometria); N/A (textura) |
meshy-6 | Ativo | N/A | N/A |
meshy-6-lite | Ativo | N/A | N/A |
meshy-n1 | Ativo | N/A | N/A |
meshy-5 | Retirado | 11 de setembro de 2026 | 10 de outubro de 2026 |
meshy-4 | Retirado | N/A | 20 de março de 2026 |
meshy-3 | Retirado | 14 de janeiro de 2025 | julho de 2025 |
meshy-t2.5 | Ativo | N/A | N/A |
meshy-t2 | Ativo | N/A | N/A |
meshy-t1 | Obsoleto | 13 de julho de 2026 | 30 de novembro de 2026 |
model_type: "lowpoly" | Obsoleto | 13 de julho de 2026 | 30 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"eai_model: "meshy-t1", ou commodel_type: "lowpoly"eai_modelomitido,latest, oumeshy-6. A Meshy ignoratarget_polycount,topology,image_enhancement,remove_lightingeexperimentalnelas. - Um preview de Texto para 3D com
model_type: "lowpoly"eai_modelomitido,latest,meshy-6, oumeshy-4(que, embora retirado, é aceito aqui apenas para este fallback). A Meshy ignoratarget_polycount,topologyeexperimentalnele.
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.
| Anunciado | Modelo ou recurso obsoleto | Data de retirada | Substituto recomendado |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" e meshy-t1 em Texto para 3D e Imagem para 3D | 30 de novembro de 2026 | model_type: "smart-topology" com ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d sem o prefixo /openapi | A ser anunciado | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 como o ai_model do preview de Texto para 3D, Imagem para 3D e Multi-imagem para 3D | 31 de dezembro de 2026 | meshy-7.1 |
| 2026-09-16 | Chave de API compartilhada em modo de teste | 16 de setembro de 2026 | Sua própria chave na página de chaves de API, ou o Playground |
| 2026-09-11 | meshy-5 | 10 de outubro de 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20 de março de 2026 | meshy-6 |
| 2025-10-01 | API de Texto para Voxel | 1 de outubro de 2025 | Nenhum |
| 2025-07-01 | API de Texto para textura | 1 de julho de 2025 | Retexturizar |
| 2025-01-14 | meshy-3 | julho de 2025 | meshy-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âmetro | Status | Comportamento | Substituto recomendado |
|---|---|---|---|
texture_image_url em Rigging | Obsoleto desde 23 de outubro de 2026 | Ainda 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_mode | Obsoleto desde 18 de setembro de 2026 | ultra_mode: true é o mesmo que geometry_resolution: "2k". | geometry_resolution |
hd_texture | Obsoleto desde 21 de julho de 2026 | hd_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 Remesh | Obsoleto desde 22 de maio de 2026 | Ainda funcionam. | Converter e Redimensionar |
symmetry_mode | Obsoleto desde 11 de maio de 2026 | Aceito e ignorado. | Omita-o. |
art_style no Preview de Texto para 3D | Obsoleto desde 22 de janeiro de 2026 | Aceito e ignorado. Aplicava-se apenas ao Meshy 4 e ao Meshy 5. | Omita-o. |
is_a_t_pose | Obsoleto desde 4 de dezembro de 2025 | Ainda funciona. | pose_mode |