registro de alterações

Veja todos os recursos latest e as atualizações da Meshy API e dos plugins.

Junho de 2026

`Jun 17`

Nova página de documentação API Playground: um console interativo para testar endpoints sem escrever código e, em seguida, copiar o equivalente em cURL, Python ou JavaScript. Disponível nos planos Pro, Studio e Enterprise.

`Jun 15`

Nova API de Desdobramento UV: gere um layout UV de alta qualidade para um modelo 3D existente — a etapa pré-requisito antes da texturização, ou sempre que você precisar de um layout UV limpo e sem sobreposição para ferramentas downstream. Recebe um input_task_id (uma tarefa concluída de Imagem para 3D, Texto para 3D ou Remesh) ou um model_url (somente .glb) e retorna um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas de até 40.000 faces (execute Remesh primeiro se for maior); malhas quad e n-gon são trianguladas durante a geração de UV.

`Jun 12`

Atualizados os preços de Build da API do Creative Lab para 30 créditos por chamada para chaveiro, ímã de geladeira e figura (anteriormente 20). luminária permanece inalterada em 30 créditos. Os preços de protótipo permanecem inalterados em 6 créditos por imagem. Consulte Preços para a divisão completa.

`Jun 5`

Adicionado o parâmetro opcional alpha_thumbnail às APIs Imagem para 3D, Multi-imagem para 3D, Texto para 3D, Retexturizar, Remesh e Reparar imprimibilidade. Quando definido como true, a tarefa também renderiza uma versão com fundo transparente (RGBA) da pré-visualização e a retorna no novo campo de resposta alpha_thumbnail_url. O thumbnail_url existente permanece inalterado. O padrão é false.

`Jun 1`

Novas APIs do Creative Lab: uma família de endpoints com escopo por produto que transformam uma foto de origem (ou prompt de texto) em um produto de consumo imprimível em 3D. Quatro produtos no lançamento — chaveiro, ímã de geladeira, figura e luminária. Cada um segue um fluxo de trabalho em duas etapas prototype → build encadeado via input_task_id, servido em URLs com escopo por produto (/openapi/creative-lab/<product>/v1/...) com versionamento por produto para que os produtos possam evoluir em linhas de versão independentes. Protótipo: 6 créditos por chamada. Construção: 30 créditos por chamada.

Maio de 2026

`May 26`

Adicionado o parâmetro multi_view_thumbnails à API Multi-imagem para 3D. Quando definido como true, a tarefa renderiza adicionalmente quatro miniaturas de vistas cardinais (frente, direita, trás, esquerda) e as retorna no novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.

`May 22`

A funcionalidade de Converter e Redimensionar da API Remesh agora está disponível como endpoints independentes da API Converter e da API Redimensionar. Os parâmetros obsoletos (deprecated) no Remesh continuarão funcionando para compatibilidade com versões anteriores.

`May 13`

Adicionado o parâmetro multi_view_thumbnails à API Imagem para 3D. Quando definido como true, a tarefa renderiza adicionalmente quatro miniaturas de vistas cardeais (frente, direita, trás, esquerda) e as retorna no novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.

`May 12`

Adicionado o parâmetro resize_longest_side à API Remesh. Redimensiona o modelo para que a dimensão mais longa da caixa delimitadora seja igual ao valor especificado em metros. Mutuamente exclusivo com resize_height e auto_size.

`May 11`

Obsoleto (deprecated) o parâmetro symmetry_mode nos endpoints Texto para 3D, Imagem para 3D e Multi-imagem para 3D. Este parâmetro não afeta mais a saída.

`May 7`

Nova API de Analisar imprimibilidade: analise uma tarefa Meshy concluída — ou qualquer URL de modelo 3D — quanto à prontidão para impressão 3D FDM. Padrão assíncrono de criação + stream: POST retorna um task_id e, em seguida, GET / stream SSE retorna métricas de estanqueidade, volume, furos e arestas non-manifold quando SUCCEEDED. Gratuito, nenhum crédito consumido.
Nova API de Reparar imprimibilidade: repare um modelo 3D para imprimibilidade FDM — corrija arestas non-manifold, faces degeneradas, furos e outros problemas de topology. Aceita um input_task_id Meshy existente ou um model_url (.glb, .stl, .obj). O formato de saída corresponde ao de entrada. 10 créditos por tarefa.

Abril de 2026

`Apr 27`

Adicionado o campo consumed_credits a todas as respostas de tarefas em todos os endpoints da API. Mostra o número de créditos consumidos por cada tarefa. O campo está presente para tarefas nos status PENDING, IN_PROGRESS e SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados automaticamente em caso de falha). Consulte Preços para ver os custos em créditos por endpoint.

`Apr 24`

Adicionado o parâmetro model_url ao endpoint impressão multicolorida. Envie um modelo 3D com textura diretamente (via URL ou Data URI) em vez de um input_task_id de uma tarefa Meshy anterior. Formatos compatíveis: .glb, .fbx. Quando ambos model_url e input_task_id são fornecidos, input_task_id tem prioridade.

`Apr 21`

Adicionado o parâmetro input_task_id aos endpoints Imagem para 3D e Multi-imagem para 3D. Referencie diretamente a saída de uma tarefa concluída de Texto para imagem ou Imagem para imagem em vez de fornecer image_url / image_urls. Quando ambos são fornecidos, input_task_id tem prioridade.

`Apr 20`

Adicionado o parâmetro hd_texture aos endpoints Imagem para 3D, Multi-imagem para 3D, Refinamento de Texto para 3D e Retexturizar. Quando habilitada, a textura de cor base é gerada em resolução 4K (4096×4096) para maior nível de detalhe. Suportado apenas para meshy-6 e latest. O padrão é false.
O pacote PBR retornado quando enable_pbr é true agora inclui um mapa emission em texture_urls para tarefas meshy-6 e latest em Imagem para 3D, Multi-imagem para 3D, Refinamento de Texto para 3D e Retexturizar. Nenhuma alteração na requisição é necessária.

`Apr 14`

Adicionado o parâmetro decimation_mode aos endpoints Imagem para 3D, Multi-imagem para 3D, Prévia de Texto para 3D e Remesh. Define o nível de contagem de polígonos da decimação adaptativa: 1 (ultra), 2 (alto), 3 (médio) ou 4 (baixo).

`Apr 12`

Documentação da API reestruturada: adicionado agrupamento de parâmetros com campos dependentes, padrões inline, selos de obrigatório/obsoleto, subnavegação expansível, e Multi-Imagem, Rigging e Animação separados em páginas distintas.

Março de 2026

`Apr 2`

Adicionado suporte ao formato 3mf ao parâmetro target_formats em todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Observação: 3MF é apenas opcional e deve ser solicitado explicitamente.
Nova API de Impressão Multicolorida: Converter modelos 3D para o formato 3MF multicolorido para impressão 3D. Suporta paletas de cores de 1 a 16 cores com precisão configurável. 10 créditos por tarefa.

`Mar 20`

O modelo de IA Meshy-4 foi descontinuado. Todas as solicitações de API usando meshy-4 não são mais compatíveis. Migre para meshy-6 ou latest.
Adicionados os parâmetros auto_size e origin_at aos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D e Remesh. Quando auto_size está habilitado, o serviço usa visão por IA para estimar a altura no mundo real e redimensionar o modelo automaticamente. origin_at define a posição da origem (bottom ou center). Na API de Remesh, auto_size é mutuamente exclusivo com resize_height.

`Mar 17`

Adicionado o parâmetro opcional target_formats aos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D e Retexturizar. Especifique quais formatos 3D gerar (por exemplo, ["glb", "fbx"]) para reduzir o tempo de conclusão da tarefa.

Fevereiro de 2026

`Feb 28`

Adicionado o parâmetro remove_lighting às APIs Imagem para 3D, Multi-imagem para 3D, Refinamento de Texto para 3D e Retexturizar. Remove realces e sombras da textura de cor base para resultados mais limpos sob iluminação personalizada. Compatível apenas com meshy-6 e latest. O padrão é true.
As APIs Retexturizar e Refinamento de Texto para 3D agora são compatíveis com meshy-6 como um valor de ai_model para texturização completa do Meshy 6.

`Feb 25`

Adicionado o parâmetro image_enhancement às APIs Imagem para 3D e Multi-imagem para 3D para usuários que desejam desativar a otimização da imagem de entrada e preservar a aparência exata da entrada. Compatível apenas com meshy-6 e latest. O padrão é true.

`Feb 20`

Adicionado o parâmetro model_type à API Pré-visualização de Texto para 3D para gerar malhas low-poly otimizadas para polígonos mais limpos.

Janeiro de 2026

`Jan 27`

Adicionada documentação detalhada de Modos de falha para todos os Endpoints da API, incluindo códigos de erro HTTP comuns (400, 401, 402, 404, 422, 429) e motivos de falha de tarefas. Isso ajuda os desenvolvedores a entender e tratar melhor os erros da API.

`26 de jan.`

A API Multi-imagem para 3D agora oferece suporte ao Meshy-6 para geração completa de malha. O parâmetro ai_model agora aceita meshy-6 e latest é resolvido como Meshy 6.

`Jan 22`

Marcado art_style como obsoleto para a API de Preview de Texto para 3D (Meshy-6). O parâmetro foi projetado para modelos Legacy (Meshy-4 / Meshy-5) e será removido em uma versão futura.
Marcado enable_pbr como obsoleto para as APIs de Texto para 3D e Imagem para 3D quando ai_model é meshy-4. Este parâmetro será removido em uma versão futura.
Atualizado o valor padrão do parâmetro should_remesh para Meshy-6 nas APIs de Texto para 3D e Imagem para 3D. O parâmetro agora usa false como padrão para meshy-6, e true para outros modelos se não for especificado.

`Jan 19`

A opção latest para ai_model nas APIs Texto para 3D (Prévia) e Imagem para 3D agora resolve para Meshy 6.

`Jan 12`

Adicionado um novo parâmetro model_type à API Imagem para 3D para gerar malhas low-poly otimizadas para polígonos mais limpos.

Dezembro de 2025

`Dec 31`

Lançado o API Playground, um espaço dedicado para desenvolvedores explorarem parâmetros da API e testarem requisições diretamente no site da Meshy.
Introduzidas a API de Texto para imagem e a API de Imagem para imagem, permitindo geração de imagens com IA a partir de prompts de texto e edição de imagens a partir de imagens de referência. Ambas as APIs são compatíveis com os modelos nano-banana e nano-banana-pro, com geração multivista opcional.

`22 de dez.`

O campo video_url na resposta da API Texto para 3D agora está obsoleto e será removido em uma versão futura.

`Dec 04`

Adicionado um novo parâmetro pose_mode às APIs Prévia de Texto para 3D, Imagem para 3D e Multi-imagem para 3D. Este parâmetro aceita a-pose, t-pose ou uma string vazia (padrão). O parâmetro is_a_t_pose agora está obsoleto em favor de pose_mode.

Novembro de 2025

`Nov 24`

As APIs Imagem para 3D e Multi-imagem para 3D adicionam um parâmetro opcional save_pre_remeshed_model e expõem model_urls.pre_remeshed_glb quando um backup pré-Remesh é solicitado.

`Nov 06`

A API de refinamento de Texto para 3D agora oferece suporte a ai_model = latest, que resolve para Meshy 6 Preview.
A API de Imagem para 3D agora usa por padrão a texturização do Meshy-6-preview quando ai_model = latest e should_texture = true.
A API de Multi-imagem para 3D agora oferece suporte a ai_model = latest, executando o Meshy-6-preview para texturização por padrão, enquanto a Geração de malha permanece Meshy-5.
A API de Retexturizar adiciona uma opção latest para ai_model (Meshy-6-preview) e agora a usa por padrão quando omitida.

`Nov 04`

A API de Remesh agora preserva texturas para modelos enviados.
A API de Retexturizar agora preserva texturas para modelos enviados quando a opção enable_original_uv está habilitada.

Outubro de 2025

`Oct 28`

Adicionado o cabeçalho de resposta x-api-version para indicar a versão atual do servidor da API.

`Oct 20`

Adicionado um parâmetro booleano opcional convert_format_only à API de Remesh para oferecer suporte à conversão apenas do formato do arquivo de modelo de entrada.
Adicionado rigged_character_glb_url à resposta de O objeto da tarefa de rigging.

`Oct 01`

Remover APIs text-to-voxel

Setembro de 2025

`Sep 23`

Adicionada uma opção latest para ai_model na API Texto para 3D para usar o Meshy 6 Preview.
Desconto temporário de 50% em vigor para tarefas de geração Meshy-6-preview, reduzindo para 10 créditos, válido até 30 de setembro de 2025. Após o período de desconto, o custo das tarefas Meshy-6-preview retornará ao normal de 20 créditos.

`18 de set.`

Atualizamos os preços da API para Texto para 3D e Imagem para 3D para refletir custos diferentes para o Meshy 6 e outros modelos.

`Sep 16`

Adicionada uma opção latest para ai_model na API Imagem para 3D para usar o Meshy 6 Preview.

`Sep 4`

Expandimos o suporte de entrada de model_url para .glb, .gltf, .obj, .fbx, .stl para Remesh e Retexturizar.

Agosto de 2025

`Aug 18`

Adicionado um parâmetro opcional is_a_t_pose às APIs Texto para 3D Preview, Imagem para 3D e Multi-imagem para 3D para gerar modelos em uma pose A/T.

`Aug 13`

Meshy 5 agora está estável para Texto para 3D e Imagem para 3D (ai_model: meshy-5), oferecendo qualidade e consistência aprimoradas.

Julho de 2025

`Jul 31`

Suporte a mapas de textura PBR na API via parâmetro enable_pbr para o modelo meshy-5 latest para os endpoints Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar.

Junho de 2025

`Jun 25`

Adicionada a API de Retexturizar, que permite aos usuários retexturizar modelos 3D com base nos modelos de IA fundacionais latest da Meshy.

`Jun 19`

Adicionadas APIs de exclusão para Texto para 3D, Imagem para 3D, Remesh, rigging e Animação.
Adicionado o parâmetro ai_model à API de Refinamento de Texto para 3D.

`Jun 17`

Adicionada a documentação para Webhooks.

`Jun 10`

A API de Remesh agora oferece suporte a modelos no formato GLB codificados em base64 no parâmetro model_url via Data URI.

Maio de 2025

`May 20`

Adicionado um parâmetro opcional moderation às APIs Texto para 3D Preview, Texto para 3D Refine, Imagem para 3D e Multi-imagem para 3D. Quando ativado, o conteúdo de entrada é automaticamente analisado quanto a conteúdo potencialmente prejudicial antes da geração.

`May 15`

Introduzida a API de Auto-rigging e Animação, permitindo que os usuários façam rigging e animem modelos 3D automaticamente. Saiba mais sobre Rigging e Animação.

Abril de 2025

`Apr 29`

Introduzida a API Multi-imagem para 3D, permitindo a geração de modelos 3D a partir de 1 a 4 imagens de entrada usando o modelo de IA meshy-5.
Adicionada a opção de modelo de IA meshy-5 às APIs Texto para 3D e Imagem para 3D. A tag latest agora também resolve para meshy-5.

`Apr 17`

Adicionado o parâmetro texture_image_url às APIs Imagem para 3D e Refinamento de Texto para 3D, permitindo que os usuários orientem o processo de geração de textura com uma imagem.

Março de 2025

`Mar 28`

Adicionado o parâmetro latest às APIs de Texto para 3D e Imagem para 3D, permitindo acesso aos nossos futuros modelos avançados de IA para melhorar a qualidade da geração.

`14 de mar.`

A API de Texto para textura agora oferece suporte a modelos codificados em base64 no parâmetro model_url via Data URI, semelhante ao image_url na API de Imagem para 3D.

`Mar 06`

Preços atualizados para tarefas de geração da API:
- Texto para 3D (Prévia): Aumentou de 2 para 5 créditos por chamada
- Texto para 3D (Refinar): Aumentou de 5 para 10 créditos por chamada
- Imagem para 3D: Agora 5 créditos sem textura, 15 créditos com textura
- Texto para textura: Aumentou de 5 para 10 créditos por chamada
- Texto para Voxel: Permanece em 5 créditos por chamada

Fevereiro de 2025

`Feb 18`

Adicionada uma chave de API do modo de teste msy_dummy_api_key_for_test_mode_12345678 que permite que desenvolvedores testem a integração da API sem consumir créditos. Todas as solicitações válidas usando esta chave retornarão os mesmos resultados de tarefa de exemplo.

`Feb 13`

Alterações incompatíveis:
- A criação de tarefas no nível gratuito será encerrada em March 20, 2025. Depois disso, todas as solicitações de tarefas da API exigirão uma assinatura paga. Para manter seu acesso sem interrupções, recomendamos fazer o upgrade antes do prazo.
- Use o código de cupom APIACCESS para obter um desconto de 40%. Obrigado por estar conosco!
Adicionados endpoints de streaming de Server-Sent Events (SSE) para atualizações de tarefas em tempo real:

`Feb 6`

Adicionado o parâmetro texture_prompt às APIs Imagem para 3D e Refinamento de Texto para 3D, permitindo que os usuários orientem o processo de geração de textura com um prompt de texto.

Janeiro de 2025

`Jan 23`

Adicionados endpoints para listar tarefas às APIs Texto para 3D, Imagem para 3D, Remesh e Texto para textura.

`Jan 14`

Tornou obsoleto as APIs Legacy de Texto para 3D e Imagem para 3D impulsionadas pelos modelos de IA Meshy-3.

`Jan 07`

Adicionado o parâmetro symmetry_mode às APIs Prévia de Texto para 3D e Imagem para 3D, permitindo configurações de simetria configuráveis.

Dezembro de 2024

`Dec 19`

Adicionadas as APIs de Remesh, que permitem aos usuários refazer a malha e exportar modelos 3D existentes gerados por outras Meshy APIs em diversos formatos.
Atualizados os limites de contagem de polígonos das nossas APIs para uma faixa de 100-300.000 para usuários Premium.

`Dec 12`

Marcou a propriedade model_url como obsoleto em todos os objetos de resposta.
Separou a API Meshy-3 Legacy da API Meshy-4 latest.

`Dec 10`

Adicionado um parâmetro enable_pbr às APIs de Imagem para 3D e Refinamento de Texto para 3D.
Adicionado um parâmetro should_texture à API de Imagem para 3D.
Definida como obsoleto a opção pbr no parâmetro art_style para a API de Prévia de Texto para 3D ao usar o modelo de IA meshy-4.
Definida como obsoleto a opção low-poly no parâmetro art_style para a API de Prévia de Texto para 3D.

`Dec 5`

Adicionada uma API de saldo para permitir que os usuários recuperem seu saldo de créditos.
Adicionado um parâmetro should_remesh às APIs Imagem para 3D e Pré-visualização de Texto para 3D.

`Dec 3`

APIs externas agora usam o prefixo /openapi. Caminhos Legacy continuam sendo compatíveis, mas recomendamos mudar para os novos caminhos.

Novembro de 2024

`Nov 14`

A API de Imagem para 3D agora oferece suporte a imagens codificadas em base64.