registo de alterações

Veja todas as funcionalidades e atualizações latest da Meshy API e dos plugins.

Junho de 2026

`Jun 17`

Nova página de documentação API Playground: uma consola interativa para experimentar endpoints sem escrever código e, depois, copiar o equivalente em cURL, Python ou JavaScript. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.

`Jun 15`

Nova API de Desdobramento UV: gera uma disposição UV de alta qualidade para um modelo 3D existente — o passo pré-requisito antes da texturização, ou sempre que precisar de uma disposição UV limpa e sem sobreposições para ferramentas a jusante. Recebe um input_task_id (uma tarefa de Imagem para 3D, Texto para 3D ou Remesh concluída) ou um model_url (apenas .glb) e devolve um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas até 40 000 faces (execute primeiro Remesh se forem maiores); malhas quad e n-gon são trianguladas durante a geração UV.

`Jun 12`

Atualizados os preços de Build da API Creative Lab para 30 créditos por chamada para porta-chaves, íman de frigorífico e figura (anteriormente 20). candeeiro mantém-se inalterado a 30 créditos. Os preços de protótipo mantêm-se inalterados a 6 créditos por imagem. Consulte Preços para a discriminaçã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 renderiza adicionalmente uma versão da pré-visualização com fundo transparente (RGBA) e devolve-a no novo campo de resposta alpha_thumbnail_url. O thumbnail_url existente permanece inalterado. A predefinição é false.

`Jun 1`

Novas APIs do Creative Lab: uma família de endpoints com âmbito de produto que transformam uma fotografia de origem (ou prompt de texto) num produto de consumo imprimível em 3D. Quatro produtos no lançamento — porta-chaves, íman de frigorífico, figura, e candeeiro. Cada um segue um fluxo de trabalho em duas fases prototype → build encadeado através de input_task_id, disponibilizado em URLs com âmbito de 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 devolve-as no novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.

`May 22`

A funcionalidade de Converter e Redimensionar da API Remesh está agora disponível como endpoints autónomos API Converter e API Redimensionar. Os parâmetros obsoletos (deprecated) no Remesh continuarão a funcionar 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 cardinais (frente, direita, trás, esquerda) e devolve-as no novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.

`May 12`

Foi 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`

O parâmetro symmetry_mode nos endpoints Texto para 3D, Imagem para 3D e Multi-imagem para 3D foi tornado obsoleto. Este parâmetro já não afeta o resultado.

`May 7`

Nova API de Analisar imprimibilidade: Analise uma tarefa Meshy com estado SUCCEEDED — ou qualquer URL de modelo 3D — quanto à preparação para impressão 3D FDM. Padrão de criação assíncrona + stream: POST devolve um task_id e, em seguida, GET / stream SSE devolve métricas de estanqueidade, volume, orifícios e arestas non-manifold quando estiver SUCCEEDED. Gratuito, sem consumo de créditos.
Nova API de Reparar imprimibilidade: Repare um modelo 3D para imprimibilidade FDM — corrija arestas non-manifold, faces degeneradas, orifícios 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 cada endpoint da API. Mostra o número de créditos consumidos por cada tarefa. O campo está presente para tarefas nos estados PENDING, IN_PROGRESS e SUCCEEDED. Devolve 0 para tarefas com estado FAILED (os créditos são automaticamente reembolsados em caso de falha). Consulte Preços para os custos em créditos por endpoint.

`Apr 24`

Adicionado o parâmetro model_url ao endpoint impressão multicor. Envie diretamente um modelo 3D com texturas (via URL ou Data URI) em vez de um input_task_id de uma tarefa Meshy anterior. Formatos suportados: .glb, .fbx. Quando tanto model_url como input_task_id são fornecidos, input_task_id tem prioridade.

`21 de abr.`

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 Texto para imagem ou Imagem para imagem concluída 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, Text to 3D Refine e Retexturizar. Quando ativado, a textura de cor base é gerada em resolução 4K (4096×4096) para maior detalhe. Suportado apenas para meshy-6 e latest. A predefinição é false.
O pacote PBR devolvido quando enable_pbr é true inclui agora um mapa de emission em texture_urls para tarefas meshy-6 e latest em Imagem para 3D, Multi-imagem para 3D, Text to 3D Refine e Retexturizar. Não é necessária qualquer alteração no pedido.

`Apr 14`

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

`Apr 12`

Documentação da API reestruturada: adicionado agrupamento de parâmetros com campos dependentes, predefinições em linha, distintivos obrigatórios/obsoleto, subnavegação expansível, e Multi-Imagem, Rigging e Animação foram separadas 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). Nota: 3MF é apenas opcional e deve ser solicitado explicitamente.
Nova API de impressão multicor: Converter modelos 3D para o formato 3MF multicor para impressão 3D. Suporta paletas de 1 a 16 cores com precisão configurável. 10 créditos por tarefa.

`Mar 20`

Descontinuado o modelo de IA Meshy-4. Todos os pedidos à API que usam meshy-4 já não são suportados. 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á ativado, o serviço utiliza 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 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 os formatos 3D a 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 com iluminação personalizada. Suportado apenas para meshy-6 e latest. A predefinição é true.
As APIs Retexturizar e Refinamento de Texto para 3D suportam agora meshy-6 como valor de ai_model para a 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 utilizadores que pretendem optar por não usar a otimização da imagem de entrada e preservar o aspeto exato da sua entrada. Suportado apenas para meshy-6 e latest. A predefinição é true.

`Feb 20`

Adicionado o parâmetro model_type à API de 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 sobre 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 das tarefas. Isto ajuda os programadores a compreender e a tratar melhor os erros da API.

`26 de jan.`

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

`Jan 22`

Tornado obsoleto art_style para a API Pré-visualização de Texto para 3D (Meshy-6). O parâmetro foi concebido para modelos Legacy (Meshy-4 / Meshy-5) e será removido numa versão futura.
Tornado obsoleto enable_pbr para as APIs Texto para 3D e Imagem para 3D quando ai_model é meshy-4. Este parâmetro será removido numa versão futura.
Atualizado o valor predefinido do parâmetro should_remesh para Meshy-6 nas APIs Texto para 3D e Imagem para 3D. O parâmetro agora assume por predefinição false 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 (Preview) e Imagem para 3D é agora resolvida como 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çamento do API Playground, um espaço dedicado para os programadores explorarem parâmetros da API e testarem pedidos diretamente no site da Meshy.
Introdução da API Texto para imagem e da API Imagem para imagem, permitindo a geração de imagens com IA a partir de prompts de texto e a edição de imagens a partir de imagens de referência. Ambas as APIs suportam os modelos nano-banana e nano-banana-pro, com geração multivista opcional.

`Dec 22`

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

`Dec 04`

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

Novembro de 2025

`24 de nov.`

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 é solicitada uma cópia de segurança pré-Remesh.

`Nov 06`

A API de refinamento de Texto para 3D suporta agora ai_model = latest, que corresponde ao Meshy 6 Preview.
A API de Imagem para 3D usa agora por predefinição a texturização Meshy-6-preview quando ai_model = latest e should_texture = true.
A API de Multi-imagem para 3D suporta agora ai_model = latest, executando o Meshy-6-preview para texturização por predefiniçã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 passa agora a utilizá-la por predefinição quando omitida.

`Nov 04`

A API Remesh preserva agora as texturas dos modelos carregados.
A API Retexturizar preserva agora as texturas dos modelos carregados quando a opção enable_original_uv está ativada.

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 Remesh para suportar apenas a conversão do formato do ficheiro do modelo de entrada.
Adicionado rigged_character_glb_url à resposta de O Objeto da Tarefa de Rigging.

`Oct 01`

Remover APIs text-to-voxel

Setembro 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 o custo para 10 créditos, que durará até 30 de setembro de 2025. Após o período de desconto, o custo das tarefas Meshy-6-preview voltará aos 20 créditos normais.

`Sep 18`

Atualizados 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 utilizar o Meshy 6 Preview.

`Sep 4`

Expandido 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 Pré-visualização de Texto para 3D, Imagem para 3D e Multi-imagem para 3D para gerar modelos numa pose A/T.

`Aug 13`

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

Julho de 2025

`31 jul`

Suporte para mapas de textura PBR na API através do parâmetro enable_pbr para o modelo meshy-5 latest nos 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 utilizadores retexturizar modelos 3D com base nos modelos de IA de base latest da Meshy.

`Jun 19`

Adicionadas APIs de eliminaçã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.

`17 de jun`

Adicionada documentação para Webhooks.

`Jun 10`

A API Remesh suporta agora modelos em formato GLB codificados em base64 no parâmetro model_url através de Data URI.

Maio de 2025

`20 de maio`

Foi 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 aos utilizadores aplicar automaticamente rigging e animar modelos 3D. 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 com 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 etiqueta latest agora também resolve para meshy-5.

`Apr 17`

Foi adicionado o parâmetro texture_image_url às APIs Imagem para 3D e Refinamento de Texto para 3D, permitindo aos utilizadores orientar o processo de geração da textura com uma imagem.

Março 2025

`Mar 28`

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

`Mar 14`

A API Texto para textura agora suporta modelos codificados em base64 no parâmetro model_url através de Data URI, semelhante ao image_url na API Imagem para 3D.

`Mar 06`

Preços atualizados para tarefas de geração da API:
- Texto para 3D (Preview): Aumentou de 2 para 5 créditos por chamada
- Texto para 3D (Refine): 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
- Text to Voxel: Mantém-se 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 aos programadores testar a integração da API sem consumir créditos. Todos os pedidos válidos que utilizem esta chave devolverão os mesmos resultados de tarefa de exemplo.

`Feb 13`

Alterações incompatíveis:
- A criação de tarefas no nível gratuito terminará em March 20, 2025. Depois disso, todos os pedidos de tarefas da API exigirão uma subscrição paga. Para manter o seu acesso sem interrupções, recomendamos que faça o upgrade antes do prazo.
- Use o código de cupão APIACCESS para usufruir de um desconto de 40%. Obrigado por estar connosco!
Foram adicionados endpoints de streaming 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 aos utilizadores orientar 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`

Marcadas como obsoletas (deprecated) as APIs Legacy de Texto para 3D e Imagem para 3D baseadas nos modelos de IA Meshy-3.

`Jan 07`

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

Dezembro de 2024

`Dec 19`

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

`Dec 12`

Tornou obsoleta (deprecated) a propriedade model_url em todos os objetos de resposta.
Separou a API Legacy Meshy-3 da API Meshy-4 latest.

`Dec 10`

Foi adicionado um parâmetro enable_pbr às APIs Imagem para 3D e Refinamento de Texto para 3D.
Foi adicionado um parâmetro should_texture à API Imagem para 3D.
Tornada obsoleta (deprecated) a opção pbr no parâmetro art_style para a API Pré-visualização de Texto para 3D ao usar o modelo de IA meshy-4.
Tornada obsoleta (deprecated) a opção low-poly no parâmetro art_style para a API Pré-visualização de Texto para 3D.

`Dec 5`

Adicionada uma API de Obter Saldo para permitir aos utilizadores recuperar o 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`

As APIs externas usam agora o prefixo /openapi. Os caminhos Legacy continuam a ser suportados, mas recomendamos mudar para os novos caminhos.

Novembro de 2024

`Nov 14`

A API de Imagem para 3D agora suporta imagens codificadas em base64.