Registo de Alterações
Veja todas as funcionalidades e atualizações mais recentes da Meshy API e plugins.
Agosto 2026
Aug 13
- Adicionado
ai_model: "meshy-7"à Text to 3D API: nosso modelo de geração 3D mais recente, com geometria de maior fidelidade do que Meshy 6. Também introduz o parâmetroultra_modena tarefa de pré-visualização, que permite a geração Ultra para detalhes de superfície ainda mais finos por 5 créditos adicionais. Para texturizar com Meshy 7, passeai_model: "meshy-7"na tarefa de refino ou omitaai_modelcompletamente. - Adicionado o Smart Topology
model_typeà Text to 3D API. Definamodel_type: "smart-topology"para gerar commeshy-t2— topology mais limpa, partes nativamente separadas, saída em triângulos, e um número de faces que pode ser definido comtarget_polycount(100 a 15,000, padrão 4,000). Uma pré-visualização Smart Topology custa 5 créditos em vez de 20; veja Preços. O existentemodel_type: "lowpoly"agora está obsoleto, mas continua a servir tráfego para compatibilidade retroativa.
Aug 12
- Adicionado
ai_model: "meshy-7"à Image to 3D API: nosso modelo de geração 3D mais recente, com geometria de maior fidelidade do que Meshy 6. Também introduz o parâmetroultra_mode, que permite geração Ultra para detalhes de superfície ainda mais finos. - Adicionado
ai_model: "meshy-7"à Multi-Image to 3D API: modelo de geração multivista da Meshy, que se baseia em todas as suas vistas de entrada e orienta a texturização a partir delas. - Adicionado
ai_model: "meshy-7"à Retexture API: nosso modelo de texturização mais recente, com detalhes de superfície mais nítidos e materiais PBR mais limpos do que Meshy 6. Ele também introduz o parâmetromultiview_image_urls— forneça 1–4 vistas ordenadas do mesmo objeto para direcionar a texturização multivista.
Aug 4
- Suporte de entrada
model_urlexpandido para.glb,.gltf,.obj,.fbx,.stlpara os endpoints Analisar Imprimibilidade e Reparar Imprimibilidade (anteriormente.glb,.stl,.obj). A reparação retorna o asset reparado no seu formato de entrada.
Julho 2026
Jul 27
- Novo Creative Lab — Brick Figure API: transforma uma foto num minifigura colecionável em estilo de tijolos. Mesma fluxo de trabalho em duas etapas que a Figure API —
prototype(6 créditos) gera uma imagem conceito estilizada,build(30 créditos) transforma-a num modelo 3D texturizado com saídas GLB e OBJ + MTL. Veja Preços para a repartição completa.
Jul 22
- Novo Creative Lab — Keycap API: transforma uma foto numa tecla de teclado mecânico personalizada a cores. Fluxo de trabalho em duas etapas —
prototype(12 créditos) gera uma renderização de design de tecla finalizada, em seguida,build(50 créditos) transforma o design escolhido (viacandidate_id) num modelo de tecla 3D texturizado com saídas de bundle GLB e OBJ, exportado à escala em milímetros do mundo real. Atualmente suporta a base padrão Cherry MX 1u (cherry-mx-1x1-r1); estão planeados mais tamanhos padrão. Veja Preços para a repartição completa.
Jul 21
- Agora suportamos texturas de cor base 8K através de um novo parâmetro
texture_resolution(2k/4k/8k) nos endpoints Imagem para 3D, Multi-Imagem para 3D, Text to 3D Refine, e Retexture. Em8k, os mapas PBR são gerados em 4K e não é produzido mapa de emissão. A geração de texturas 8K custa 15 créditos (2k/4kpermanecem 10). Veja Preços. - O booleano
hd_textureestá obsoleto em favor detexture_resolution— ainda é honrado e equivalente atexture_resolution: "4k"para compatibilidade retroativa.
Jul 20
- Novo Creative Lab — Vinyl Figure API: transformar uma foto numa figura 3D colecionável de vinil com cabeça grande. Mesma fluxo de trabalho em duas etapas que a Figure API —
prototype(6 créditos) gera uma imagem conceito estilizada,build(30 créditos) transforma-a num modelo 3D texturizado com saídas GLB e OBJ + MTL. Veja Preços para a repartição completa.
Jul 13
- Adicionado um novo Smart Topology
model_typeà Image to 3D API, oferecendo dois modelos através deai_model:meshy-t1— o modelo atual low-poly — emeshy-t2— um novo modelo com topology mais limpa, partes nativamente separadas, saída em triângulos, e um número de faces que pode ser definido comtarget_polycount.meshy-t2é o padrão sobsmart-topology. O existentemodel_type: lowpolyagora está obsoleto, mas continua a servir tráfego para compatibilidade retroativa.
Jul 7
- Adicionado o parâmetro
aspect_ratioà Image to Image API, para que você possa controlar a proporção da imagem de saída ao editar. Os valores permitidos são1:1,16:9,9:16,4:3,3:4para os modelos nano-banana e1:1,3:2,2:3paragpt-image-2. Opcional; padrão é1:1, e não pode ser combinado comgenerate_multi_view.
Junho 2026
Jun 17
- Nova página de documentação do API Playground: um console interativo para testar endpoints sem escrever código, depois copiar o equivalente no cURL, Python ou JavaScript. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.
Jun 15
- Nova UV Unwrap API: gerar 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ção para ferramentas posteriores. Aceita um
input_task_id(uma tarefa Image to 3D, Text to 3D, ou Remesh concluída) ou ummodel_url(.glbapenas) e retorna um "modelo branco UV" com coordenadas UV novas. 5 créditos por chamada. Suporta malhas de até 40,000 faces (execute Remesh primeiro se maior); malhas quad e n-gon são trianguladas durante a geração UV.
Jun 12
- Preços de construção da Creative Lab API atualizados para 30 créditos por chamada para Porta-chaves, Íman de Frigorífico, e Figura (anteriormente 20). Candeeiro permanece inalterado em 30 créditos. Preço de protótipo permanece inalterado em 6 créditos por imagem. Veja Preços para a repartição completa.
Jun 5
- Adicionado o parâmetro opcional
alpha_thumbnailà Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh, e Repair Printability APIs. Quando configurado paratrue, a tarefa renderiza adicionalmente uma versão com fundo transparente (RGBA) da pré-visualização e a retorna sob o novo campo de respostaalpha_thumbnail_url. O existentethumbnail_urlpermanece inalterado. O padrão éfalse.
Jun 1
- Novas Creative Lab APIs: uma família de endpoints de produto que transformam uma foto fonte (ou prompt de texto) num produto de consumidor 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 etapas
prototype→buildencadeado através deinput_task_id, servido sob URLs específicos 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 2026
May 26
- Adicionado o parâmetro
multi_view_thumbnailsà Multi-Image to 3D API. Quando configurado paratrue, a tarefa renderiza adicionalmente quatro miniaturas de vistas cardeais (frente, direita, trás, esquerda) e as retorna sob o novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.
May 22
- A funcionalidade de conversão e redimensionamento da Remesh API agora está disponível como endpoints Convert API e Resize API independentes. Os parâmetros obsoletos em Remesh continuarão a funcionar para compatibilidade retroativa.
May 13
- Adicionado o parâmetro
multi_view_thumbnailsà Image to 3D API. Quando configurado paratrue, a tarefa renderiza adicionalmente quatro miniaturas de vistas cardeais (frente, direita, trás, esquerda) e as retorna sob o novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.
May 12
- Adicionado parâmetro
resize_longest_sideà Remesh API. Redimensiona o modelo para que a dimensão mais longa da caixa delimitadora seja igual ao valor especificado em metros. Mutuamente exclusivo comresize_heighteauto_size.
May 11
- Parâmetro
symmetry_modeobsoleto nas endpoints Text to 3D, Image to 3D, e Multi-Image to 3D. Este parâmetro já não afeta a saída.
May 7
- Novo Analisar Imprimibilidade API: Analise uma tarefa Meshy bem-sucedida — ou qualquer URL de modelo 3D — para prontidão de impressão 3D FDM. Padrão de criação assíncrona + fluxo de transmissão: POST retorna um task_id, em seguida GET / fluxo SSE retorna a estanqueidade, volume, medidas de orifício e aresta não-manifold uma vez que SUCCEEDED. Gratuito, nenhum crédito consumido.
- Nova Reparar Imprimibilidade API: Repare um modelo 3D para imprimibilidade FDM — corrige arestas non-manifold, faces degeneradas, orifícios e outros problemas de topology. Aceita um
input_task_idMeshy existente ou ummodel_url(.glb,.stl,.obj). O formato de saída corresponde ao de entrada. 10 créditos por tarefa.
Abril 2026
Apr 27
- Adicionado campo
consumed_creditsa 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 estadosPENDING,IN_PROGRESS, eSUCCEEDED. Retorna0para tarefasFAILED(os créditos são automaticamente reembolsados em caso de falha). Veja Preços para custos de créditos por endpoint.
Apr 24
- Adicionado parâmetro
model_urlao endpoint Impressão Multicor. Submeta um modelo 3D texturizado diretamente (via URL ou Data URI) em vez de uminput_task_idde uma tarefa Meshy anterior. Formatos suportados:.glb,.fbx. Quando ambosmodel_urleinput_task_idsão fornecidos,input_task_idtem prioridade.
Apr 21
- Adicionado parâmetro
input_task_idaos endpoints Image to 3D e Multi-Image to 3D. Referencie a saída de uma tarefa Texto para Imagem ou Imagem para Imagem concluída diretamente em vez de fornecerimage_url/image_urls. Quando ambos são fornecidos,input_task_idtem prioridade.
Apr 20
- Adicionado parâmetro
hd_textureaos endpoints Image to 3D, Multi-Image to 3D, Text to 3D Refine, e Retexture. Quando ativado, a cor base da textura é gerada na resolução de 4K (4096×4096) para maior detalhe. Apenas suportado parameshy-6elatest. O padrão éfalse. - O pacote PBR retornado quando
enable_pbrétrueagora inclui um mapaemissionsobtexture_urlspara tarefasmeshy-6elatestem Image to 3D, Multi-Image to 3D, Text to 3D Refine, e Retexture. Não é necessária alteração no pedido.
Apr 14
- Adicionado parâmetro
decimation_modeaos endpoints Image to 3D, Multi-Image to 3D, Text to 3D Preview, e Remesh. Define o nível de contagem de polígonos de decimação adaptativa:1(ultra),2(alto),3(médio), ou4(baixo).
Apr 12
- Reestruturada a documentação da API: adicionada agrupamento de parâmetros com campos dependentes, padrões inline, crachás obrigatórios/obsoletos, sub-navegação expansível, e divididas as páginas Multi-Image, Rigging, e Animação em páginas separadas.
Março 2026
Apr 2
- Adicionado suporte de formato
3mfao parâmetrotarget_formatsem todos os endpoints (Image to 3D, Text to 3D, Remesh, Retexture). Nota: 3MF é apenas opt-in e deve ser solicitado explicitamente. - Nova Impressão Multicor API: Converter modelos 3D para o formato 3MF multicor para impressão 3D. Suporta paletas de 1-16 cores com precisão configurável. 10 créditos por tarefa.
Mar 20
- Aposentado o modelo AI Meshy-4. Todos os pedidos à API usando
meshy-4já não são suportados. Por favor, migre parameshy-6oulatest. - Adicionados parâmetros
auto_sizeeorigin_ataos endpoints Image to 3D, Multi-Image to 3D, Text to 3D, e Remesh. Quando oauto_sizeestá ativado, o serviço usa visão AI para estimar a altura do mundo real e redimensionar o modelo automaticamente.origin_atdefine a posição de origem (bottomoucenter). Na API Remesh,auto_sizeé mutuamente exclusivo comresize_height.
Mar 17
- Adicionado parâmetro opcional
target_formatsaos endpoints Image to 3D, Multi-Image to 3D, Text to 3D, e Retexture. Especifica quais formatos 3D gerar (por exemplo,["glb", "fbx"]) para reduzir o tempo de conclusão da tarefa.
Fevereiro 2026
Feb 28
- Adicionado parâmetro
remove_lightingaos endpoints Image to 3D, Multi-Image to 3D, Text to 3D Refine, e Retexture. Remove destaques e sombras da cor base da textura para resultados mais limpos sob iluminação personalizada. Apenas suportado parameshy-6elatest. O padrão étrue. - As APIs Retexture e Text to 3D Refine agora suportam
meshy-6como um valorai_modelpara texturização Meshy 6 completa.
Feb 25
- Adicionado parâmetro
image_enhancementàs APIs Image to 3D e Multi-Image to 3D para os usuários que desejam optar por não realizar otimização de imagem de entrada e preservar a aparência exata da sua entrada. Apenas suportado parameshy-6elatest. O padrão étrue.
Feb 20
- Adicionado parâmetro
model_typeà Text to 3D Preview API para gerar malhas low-poly otimizadas para polígonos mais limpos.
Janeiro 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 razões de falha de tarefas. Isso ajuda os desenvolvedores a entender e lidar melhor com erros da API.
Jan 26
- A Multi-Image to 3D API agora suporta Meshy-6 para geração completa de malha. O parâmetro
ai_modelagora aceitameshy-6elatestresolve para Meshy 6.
Jan 22
- Parâmetro
art_styleobsoleto para a Text to 3D Preview API (Meshy-6). O parâmetro foi projetado para modelos legados (Meshy-4 / Meshy-5) e será removido em uma versão futura. - Parâmetro
enable_pbrobsoleto para as APIs Text to 3D e Image to 3D quandoai_modelémeshy-4. Este parâmetro será removido em uma versão futura. - Valor padrão atualizado do parâmetro
should_remeshpara Meshy-6 nas APIs Text to 3D e Image to 3D. O parâmetro agora tem padrãofalseparameshy-6, etruepara outros modelos, se não especificado.
Jan 19
- A opção
latestparaai_modelnas APIs Text to 3D (Preview) e Image to 3D agora resolve para Meshy 6.
Jan 12
- Adicionado um novo parâmetro
model_typeà Image to 3D API para gerar malhas low-poly otimizadas para polígonos mais limpos.
Dezembro 2025
Dec 31
- Lançado o API Playground, um espaço dedicado para desenvolvedores explorarem os parâmetros da API e testarem solicitações diretamente no site Meshy.
- Introduzidas a Text to Image API e a Image to Image API, permitindo a geração de imagens com tecnologia AI a partir de prompts de texto e edição de imagens a partir de imagens de referência. Ambas as APIs suportam os modelos
nano-bananaenano-banana-pro, com geração multivista opcional.
Dec 22
- O campo
video_urlna resposta da API Text to 3D agora está obsoleto e será removido em uma versão futura.
Dec 04
- Adicionado um novo parâmetro
pose_modeaos endpoints Text to 3D Preview, Image to 3D, e Multi-Image to 3D. Este parâmetro aceitaa-pose,t-pose, ou uma string vazia (padrão). O parâmetrois_a_t_poseagora está obsoleto em favor depose_mode.
Novembro 2025
Nov 24
- As APIs Image to 3D e Multi-Image to 3D adicionam um parâmetro opcional
save_pre_remeshed_modele expõemmodel_urls.pre_remeshed_glbquando um backup pré-remesh é solicitado.
Nov 06
- A Text to 3D Refine API agora suporta
ai_model = latest, que resolve para Meshy 6 Preview. - A Image to 3D API agora tem como padrão texturização Meshy-6-preview quando
ai_model = latesteshould_texture = true. - A Multi-Image to 3D API agora suporta
ai_model = latest, executando Meshy-6-preview para texturização por padrão, enquanto a geração de malha permanece Meshy-5. - A Retexture API adiciona uma opção
latestparaai_model(Meshy-6-preview) e agora tem como padrão quando omitido.
Nov 04
- A Remesh API agora preserva texturas para modelos carregados.
- A Retexture API agora preserva texturas para modelos carregados quando a opção
enable_original_uvestá ativada.
Outubro 2025
Oct 28
- Adicionado o cabeçalho de resposta
x-api-versionpara indicar a versão atual do servidor da API.
Oct 20
- Adicionado um parâmetro booleano opcional
convert_format_onlyà Remesh API para suportar a conversão apenas do formato do arquivo de modelo de entrada. - Adicionado
rigged_character_glb_urlà resposta de The Rigging Task Object.
Oct 01
- Remover APIs
text-to-voxel
Setembro 2025
Sep 23
- Adicionada uma opção
latestparaai_modelna Text to 3D API para usar Meshy 6 Preview. - Desconto temporário de 50% em vigor para tarefas de geração Meshy-6-preview 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á ao normal de 20 créditos.
Sep 18
- Preços de API atualizados para Text to 3D e Image to 3D para refletir diferentes custos para Meshy 6 e outros modelos.
Sep 16
- Adicionado uma opção
latestparaai_modelna Image to 3D API para usar Meshy 6 Preview.
Sep 4
Agosto 2025
Aug 18
- Adicionado um parâmetro opcional
is_a_t_poseaos endpoints Text to 3D Preview, Image to 3D, e Multi-Image to 3D para gerar modelos em uma pose A/T.
Aug 13
- Meshy 5 agora é estável para Text to 3D e Image to 3D (
ai_model:meshy-5), entregando qualidade e consistência aprimoradas.
Julho 2025
Jul 31
- Suporte para mapas de textura PBR na API via parâmetro
enable_pbrno modelo mais recentemeshy-5para Text to 3D, Image to 3D, Multi-Image to 3D, e Retexture endpoints.
Junho 2025
Jun 25
- Adicionada a Retexture API, que permite aos usuários retexturizar modelos 3D com base nos modelos AI de última geração da Meshy.
Jun 19
- Adicionados APIs de exclusão para Text to 3D, Image to 3D, Remesh, Rigging, e Animation.
- Adicionado o parâmetro
ai_modelà Text to 3D Refine API.
Jun 17
- Adicionado documentação para Webhooks.
Jun 10
- A Remesh API agora suporta modelos no formato GLB codificados em base64 no parâmetro
model_urlvia Data URI.
Maio 2025
May 20
- Adicionado um parâmetro opcional
moderationaos endpoints Text to 3D Preview, Text to 3D Refine, Image to 3D, e Multi-Image to 3D. Quando ativado, o conteúdo de entrada é automaticamente examinado em busca de conteúdo potencialmente nocivo antes da geração.
May 15
- Introduzida a Auto-rigging & Animation API, permitindo aos usuários rigar e animar modelos 3D automaticamente. Saiba mais sobre Rigging e Animation.
Abril 2025
Apr 29
- Introduzida a Multi-Image to 3D API, permitindo a geração de modelos 3D a partir de 1 a 4 imagens de entrada usando o modelo AI
meshy-5. - Adicionada a opção de modelo AI
meshy-5às APIs Text to 3D e Image to 3D. A taglatestagora também resolve parameshy-5.
Apr 17
- Adicionado o parâmetro
texture_image_urlàs APIs Image to 3D e Text to 3D Refine, permitindo aos usuários guiar o processo de geração de textura com uma imagem.
Março 2025
Mar 28
- Adicionado o parâmetro
latestàs APIs Text to 3D e Image to 3D, permitindo acesso aos nossos modelos AI avançados futuros para melhoria da qualidade de geração.
Mar 14
- A Text to Texture API agora suporta modelos codificados em base64 no parâmetro
model_urlvia Data URI, semelhante aoimage_urlna Image to 3D API.
Mar 06
- Atualizado os preços para tarefas de geração de API:
- Texto para 3D (Preview): Aumentado de 2 para 5 créditos por chamada
- Texto para 3D (Refine): Aumentado 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: Aumentado de 5 para 10 créditos por chamada
- Texto para Voxel: Permanece em 5 créditos por chamada
Fevereiro 2025
Feb 18
- Adicionada uma chave de API de modo de teste que permite aos desenvolvedores testar a integração da API sem consumir créditos. Todas as solicitações válidas usando esta chave retornarão os mesmos resultados da tarefa de amostra.
Feb 13
-
Alterações Críticas:
- A criação de tarefas no nível gratuito terminará em
20 de março de 2025. Após isso, todas as solicitações de tarefas da API exigirão uma subscrição paga. Para manter seu acesso suave, recomendamos a atualização antes do prazo final. - Use o código de cupão
APIACCESSpara usufruir de um desconto de40%. Obrigado por estar conosco!
- A criação de tarefas no nível gratuito terminará em
-
Adicionado pontos de 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 Image to 3D e Text to 3D Refine, permitindo aos usuários guiar o processo de geração de textura com um prompt de texto.
Janeiro 2025
Jan 23
- Adicionados endpoints para listar tarefas nas APIs Text to 3D, Image to 3D, Remesh e Text to Texture.
Jan 14
- APIs legadas de Texto para 3D e Imagem para 3D obsoletas, alimentadas pelos modelos AI Meshy-3.
Jan 07
- Adicionado o parâmetro
symmetry_modepara as APIs Text to 3D Preview e Image to 3D, permitindo configurações de simetria configuráveis.
Dezembro 2024
Dec 19
- Adicionadas as Remesh APIs, que permitem aos usuários remeshar e exportar modelos 3D existentes gerados por outras APIs Meshy em vários formatos.
- Limites de contagem de polígonos atualizados para nossas APIs para uma faixa de 100-300,000 para usuários Premium.
Dec 12
- Propriedade
model_urlobsoleta em todos os objetos de resposta. - Separada a API Meshy-3 legada da API Meshy-4 mais recente.
Dec 10
- Adicionado um parâmetro
enable_pbràs APIs Image to 3D e Text to 3D Refine. - Adicionado um parâmetro
should_textureà API Image to 3D. - Opção
pbrobsoleta no parâmetroart_stylepara a Text to 3D Preview API quando usa o modelo AImeshy-4. - Opção
low-polyobsoleta no parâmetroart_stylepara a Text to 3D Preview API.
Dec 5
- Adicionada uma Get Balance API para permitir que os usuários recuperem o saldo de seus créditos.
- Adicionado um parâmetro
should_remeshàs APIs Image to 3D e Text to 3D Preview.
Dec 3
- APIs externas agora usam o prefixo
/openapi. Caminhos legados continuam suportados, mas recomendamos mudá-los para os novos caminhos.
Novembro 2024
Nov 14
- A Image to 3D API agora suporta imagens codificadas em base64.