Registo de alterações
Consulte todas as funcionalidades e atualizações mais recentes da Meshy API e dos plugins.
Prefere um feed em direto? As entradas mais recentes também aparecem na página de descrição geral da Developer Platform.
Outubro de 2026
Oct 6
- Analisar imprimibilidade e Reparar imprimibilidade já podem verificar a espessura de parede no tamanho em que planeia imprimir. Envie
printer_type, um tamanho de impressão, ou ambos: a análise reporta paredes finas emprintability.thin_walls, e a reparação engrossa-as quando necessário, podendo reutilizar a impressora e o tamanho de uma tarefa de análise passada comoinput_task_id. As integrações que não utilizam estes campos comportam-se como antes, e os preços mantêm-se inalterados.
Setembro 2026
Sep 29
- O caminho legado
/v2/text-to-3d(sem o prefixo/openapi) está obsoleto. Continua a funcionar sem alterações por agora, mas será removido numa versão futura — mude para/openapi/v2/text-to-3d, que aceita o mesmo pedido e devolve a mesma resposta. As respostas no caminho legado passam agora a incluir um cabeçalhoDeprecatione um cabeçalhoLinka apontar para o novo caminho.
Sep 28
- As respostas da API incluem agora cabeçalhos de limite de taxa, incluindo
Retry-Afterpara indicar quanto tempo deve esperar antes de tentar novamente ou de voltar a consultar. - Multi-Color Print aceita agora um novo parâmetro
printer_brandque escreve uma predefinição de software de corte correspondente no 3MF, de modo a que o ficheiro abra pronto a imprimir em impressoras Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker e AnkerMake, além da Bambu Lab (a predefinição). A página documenta agora tambémmax_depth.
18 de set
- Adicionado
meshy-7.1como valor deai_modelpara Imagem para 3D, Multi-imagem para 3D e Texto para 3D: mesmos parâmetros e custo em créditos quemeshy-7, com maior detalhe de geometria.latestresolve agora parameshy-7.1;meshy-7está obsoleto mas continua a funcionar sem alterações. - Adicionado
geometry_resolution(standard/2k/4k) às mesmas APIs, substituindo o agora obsoletoultra_mode(ultra_mode: truecontinua a funcionar e equivale a"2k").4krequer Meshy 7.1 (meshy-7.1oulatest), não está disponível em Multi-imagem para 3D, e custa os mesmos 5 créditos extra que2k.
Sep 16
- A API do Auto Split agora aceita um
input_task_idcom textura. Anteriormente, rejeitava-o com400, o que significava ter de gerar a mesma malha uma segunda vez comshould_texture: falseapenas para a dividir. Note o que uma divisão devolve: corta a geometria e reconstrói as superfícies de cada parte, pelo que a textura do input não é transferida e o resultado é um modelo sem textura, com uma cor lisa por parte — isso já era válido para todas as divisões e não foi alterado. - O
meshy-5será retirado a 10 de outubro de 2026. Já não está documentado como valor deai_modelpara Texto para 3D, Imagem para 3D, Multi-imagem para 3D ou Retexturizar, e, após 10 de outubro, os pedidos que enviemai_model: "meshy-5"irão devolver um erro. - A chave de API partilhada em modo de teste foi retirada; os pedidos que ainda a enviem agora devolvem
401 Unauthorized. Se a copiou para código ou CI, substitua-a pela sua própria chave a partir da página de Chaves de API. Essa chave devolvia sempre o mesmo modelo de exemplo, independentemente do input, pelo que nunca mostrava o que um pedido geraria na realidade. Para ver o que a API devolve antes de construir algo com base nela, utilize o Playground na Developer Platform, que executa uma tarefa real no seu navegador. Em planos sem acesso à API, este executa Imagem para 3D sem chave de API e utiliza os créditos da sua conta como qualquer outra tarefa.
Sep 15
- Adicionados
gpt-image-2-5-flareegpt-image-2-5-sunburstaos valores documentados deai_modelpara as APIs Texto para imagem e Imagem para imagem. Estes são níveis do OpenAI GPT Image 2.5, com o mesmo preço dogpt-image-2(Texto para imagem: 9 créditos; Imagem para imagem: 12 créditos). - Os modelos GPT Image (
gpt-image-2,gpt-image-2-5-flare,gpt-image-2-5-sunburst) agora também aceitam as proporções4:3e3:4nas APIs Texto para imagem e Imagem para imagem, além de1:1,16:9,9:16,3:2e2:3.
Sep 14
- A Image to Image API passa agora a aceitar
input_task_id— encadeie diretamente a partir de uma tarefa de Texto para imagem ou Imagem para imagem concluída, em vez de copiar os URLs do seu resultado parareference_image_urls.
Sep 11
- Alteração de comportamento:
DELETEnuma tarefa que já estejaIN_PROGRESSé agora rejeitado com409 Conflict, e a tarefa continua em execução. Anteriormente devolvia200 OK, interrompia o worker e descartava o resultado — mantendo os créditos, uma vez que só as tarefasPENDINGsão reembolsáveis, pelo que a chamada lhe custava tanto o modelo como os créditos, sem que a resposta o indicasse. Se a sua integração elimina tarefas para as cancelar, tenha em atenção que uma tarefa que o worker já tenha iniciado não pode ser cancelada: aguarde porSUCCEEDED,FAILEDouCANCELEDe só depois a elimine. As tarefasPENDINGcontinuam a ser eliminadas e reembolsadas exatamente como antes, e as tarefas em estado terminal continuam a ser eliminadas. Aplica-se a todas as famílias de tarefas sob/openapi. Consulte Erros. - Foi adicionado
meshy-6-liteaos valores documentados deai_modelpara as APIs de Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar. É o sucessor domeshy-5: os mesmos parâmetros, o mesmo custo em créditos (5 para a malha, 15 com textura, 10 para uma retexturização). - O
meshy-5está agora obsoleto em todas as APIs que o aceitam. Continua a funcionar e nada muda no seu pedido ou na sua faturação, mas deixará de aceitar novo tráfego numa versão futura — se a sua integração enviaai_model: "meshy-5", migre parameshy-6-lite.
Sep 9
- Nova API de Auto Split: Divide um modelo Meshy 6 ou Meshy 7 sem textura em peças imprimíveis separadamente — automaticamente, pelas peças que nomear (
by_parts), ou por região de cor (by_color) — com conectores de encaixe macho-fêmea opcionais e reforço de paredes finas. Exporta cada peça como o seu próprio objeto emglb,obj,fbx,usdz,blend, ou3mf, montadas ou dispostas na placa de construção (layout). 10 créditos por tarefa.
Sep 7
- Adicionado o parâmetro
name_textà etapa de protótipo da API do porta-chaves Creative Lab: grave um nome com até 10 caracteres no porta-chaves, a mesma personalização oferecida pela aplicação web. A etapa de construção herda a gravação automaticamente, e o objeto da tarefa de protótipo agora devolvename_textpara que possa confirmar o texto exato antes da construção. Note quenamecontinua a ser apenas uma etiqueta de exibição da tarefa e não é gravado.
5 de set.
- Adicionada a API Creative Lab Fidget Pixel: transforma uma fotografia numa placa fidget em pixel art multicolor, imprimível em 3D, em duas fases.
POST /prototype(6 créditos) pixeliza a fotografia numa imagem em pixel art — indiquetypecomopersonouotherpara escolher o estilo de pixelização — ePOST /build(30 créditos) amostra-a numa grelha16ou32e transforma cada pixel numa peçasquareouhexencaixável, entregue como um único 3MF com etiquetas de cor para impressão multi-filamento. A geometria das peças é ajustável através depiece_size_mm,color_countepiece_height_mm.
4 de set.
- Adicionado
GET /openapi/v1/animations/libraryà Biblioteca de animações: obtenha todas as ações predefinidas aceites pela Animation API —action_id, nome, categoria e uma pré-visualização em GIF animado — com filtros de pesquisa e de categoria, para que possa criar o seu próprio seletor de ações em vez de consultar a tabela de referência. Gratuito; não consome créditos. - Adicionada a Creative Lab Collapsible Fidget API: transforme uma fotografia num brinquedo fidget colapsável imprimível de uma só vez, em que a silhueta do sujeito se torna em anéis concêntricos aninhados que colapsam para ficarem planos e se voltam a esticar, impressos numa só peça, sem montagem. Um único
POSTleva a imagem até ao modelo final — não existe um par de etapas de protótipo/construção nem parâmetros de geometria para ajustar. Cada tarefa custa 6 créditos e devolve tanto um STL imprimível como um GLB para pré-visualização.
Sep 3
- A fase de protótipo da API do Creative Lab Lamp agora devolve um modelo 3D:
POST /prototypetransforma a imagem de conceito num GLB de candeeiro oco, e o objeto de tarefa do protótipo passa a incluirmodel_urls.glbethumbnail_urljuntamente comimage_urls. A fase de construção executa apenas o processador de candeeiro nesse modelo e agora produz um candeeiro com fundo aberto e uma placa de base para a fonte de luz. Os Preços acompanham o trabalho: o protótipo custa 30 créditos e a construção 6 créditos (anteriormente 6 e 30). O parâmetrotextdo protótipo foi removido —image_urlé agora obrigatório.
2 de setembro
- A API de Animação agora aceita
action_ids— aplique até 10 ações predefinidas a uma personagem com rig num único pedido e receba um ficheiro único contendo um clip de animação por ação, pronto a ser utilizado a partir de uma máquina de estados num motor de jogo. Os clips mantêm a ordem em que os lista e transportam o nome da biblioteca da animação. Custa 3 créditos por ação, epost_processaplica-se ao ficheiro combinado. Consulte a Referência da Biblioteca de animações para os ids disponíveis e a tabela de preços.
Sep 1
- Adicionado o parâmetro
ultra_modeà Multi-imagem para 3D API: ativa a geração Ultra noai_modelmeshy-7(oulatest) para geometria de maior fidelidade com detalhe de superfície mais fino, por 5 créditos extra — o mesmo passo Ultra que a Imagem para 3D API oferece, agora disponível com entradas multivista. - Removido
meshy-t1dos valores documentados deai_modelpara omodel_typeSmart Topology da Imagem para 3D API. O Smart Topology agora só documentameshy-t2; as novas integrações devem usá-lo em alternativa. O Meshy T1 está previsto para descontinuação — se a sua integração enviar atualmenteai_model: "meshy-t1", migre parameshy-t2.
Agosto de 2026
Aug 28
- Adicionada a API de Utilização para equipas Studio e Enterprise: exporte programaticamente o histórico de utilização de tarefas da API — endpoint, estado, timestamps, a chave de API que executou cada tarefa, e
consumed_credits— com paginação standard e filtros de janela temporal, endpoint e estado, para controlo de custos e sistemas financeiros.
Aug 26
- A API de Animação aceita agora
motion_task_id— aplique um clipe de movimento gerado com a API Text to Motion ao seu personagem bípede com rig, como alternativa a umaction_idpredefinido. Mesmo custo de 3 créditos por tarefa.
Aug 24
- Suporte alargado para
aspect_rationogpt-image-2nas APIs Texto para imagem e Imagem para imagem, adicionando16:9e9:16. Ogpt-image-2agora aceita1:1,16:9,9:16,3:2e2:3;4:3e3:4continuam por suportar para este modelo.
Aug 21
- Adicionada a API Texto para Movimento: gere um clipe de movimento de personagem a partir de uma descrição em linguagem natural, sem necessidade de modelo de personagem. Escolha o mode
prime(10 créditos, saída em FBX) para a mais alta qualidade ou o modeswift(3 créditos, saída em BVH) para uma geração rápida e económica, com durações de clipe de 2 a 10 segundos.
Aug 20
- Adicionado o parâmetro
styleà Multi-Color Print API: escolharealistic(predefinição) para cores fiéis à textura, oucartoonpara regiões de cor planas e uniformes e um 3MF mais pequeno. - Adicionado o parâmetro
remove_backgrounda todos os endpoints de protótipo do Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet e Lamp. Definaremove_background: truepara receber a imagem do protótipo como um PNG RGBA transparente com o fundo removido.
18 de ago.
- Adicionado o parâmetro
texture_image_urlsà API Multi-imagem para 3D: forneça entre 1 a 4 imagens do mesmo objeto para orientar a texturização, em vez do únicotexture_image_url. Requerai_modelmeshy-7oulatest, e é independente deimage_urls— as duas listas podem conter imagens diferentes e números diferentes de imagens.
17 de ago.
- Adicionado o parâmetro
remove_backgroundà API Texto para imagem e à API Imagem para imagem. Definaremove_background: truepara receber a imagem gerada como um PNG RGBA transparente com o fundo removido.
13 ago
- Adicionado
ai_model: "meshy-7"à API de Texto para 3D: o nosso mais recente modelo de geração 3D, com geometria de maior fidelidade do que o Meshy 6. Introduz também o parâmetroultra_modena tarefa de preview, que ativa a geração Ultra para um detalhe de superfície ainda mais fino por 5 créditos extra. Para aplicar textura com o Meshy 7, passeai_model: "meshy-7"na tarefa de refine ou omitaai_modelpor completo. - Adicionado o
model_typeSmart Topology à API de Texto para 3D. Definamodel_type: "smart-topology"para gerar commeshy-t2— topology mais limpa, partes nativamente separadas, saída em triângulos e uma contagem de faces que pode definir comtarget_polycount(100 a 15 000, valor predefinido 4 000). Um preview de Smart Topology custa 5 créditos em vez de 20; consulte Preços. Omodel_type: "lowpoly"existente está agora obsoleto, mas continua a servir tráfego para compatibilidade com versões anteriores.
Aug 12
- Adicionado
ai_model: "meshy-7"à API de Imagem para 3D: o nosso mais recente modelo de geração 3D, com geometria de maior fidelidade do que o Meshy 6. Também introduz o parâmetroultra_mode, que ativa a geração Ultra para um detalhe de superfície ainda mais fino. - Adicionado
ai_model: "meshy-7"à API de Multi-imagem para 3D: o modelo de geração Multivista da Meshy, que se baseia em conjunto em todas as suas vistas de entrada e orienta a texturização a partir delas. - Adicionado
ai_model: "meshy-7"à API de Retexturizar: o nosso mais recente modelo de texturização, com detalhe de superfície mais nítido e materiais PBR mais limpos do que o Meshy 6. Também introduz o parâmetromultiview_image_urls— forneça entre 1 e 4 vistas ordenadas do mesmo objeto para orientar a texturização multivista.
Aug 4
- Expandido o suporte de entrada
model_urlpara.glb,.gltf,.obj,.fbx,.stlnos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente.glb,.stl,.obj). A reparação devolve o asset reparado no seu formato de entrada.
Julho 2026
Jul 27
- Nova Creative Lab — Brick Figure API: transforme uma foto numa figura 3D colecionável no estilo de blocos. O mesmo fluxo de trabalho em duas fases que a Figure API —
prototype(6 créditos) gera uma imagem de conceito estilizada,build(30 créditos) transforma-a num modelo 3D texturizado com saídas em GLB e OBJ + MTL. Consulte Preços para o detalhe completo.
22 de jul.
- Nova Creative Lab — API de Keycap: transforma uma fotografia numa tecla de teclado mecânico personalizada a cores. Fluxo de trabalho em duas fases —
prototype(12 créditos) gera uma renderização do design final da tecla, depoisbuild(50 créditos) transforma o design escolhido (através decandidate_id) num modelo 3D de tecla com textura, com saídas em pacote GLB e OBJ, exportado à escala real em milímetros. Atualmente suporta a base padrão Cherry MX 1u (cherry-mx-1x1-r1); estão planeados mais tamanhos padrão. Consulte Preços para a descrição completa.
Jul 21
- Agora suportamos texturas base color 8K através de um novo parâmetro
texture_resolution(2k/4k/8k) nos endpoints Image to 3D, Multi-Image to 3D, Text to 3D Refine e Retexture. Em8k, os mapas PBR são gerados a 4K e não é produzido nenhum mapa de emissão. A geração de textura 8K custa 15 créditos (2k/4kmantêm-se em 10). Ver Pricing. - O booleano
hd_textureestá obsoleto em favor detexture_resolution— continua a ser respeitado e equivale atexture_resolution: "4k"para efeitos de compatibilidade retroativa.
Jul 20
- Nova Creative Lab — Vinyl Figure API: transforma uma fotografia numa figura colecionável 3D vinyl de cabeça grande. O mesmo fluxo de trabalho em duas etapas da Figure API —
prototype(6 créditos) gera uma imagem conceptual estilizada,build(30 créditos) transforma-a num modelo 3D texturizado com outputs em GLB e OBJ + MTL. Consulte Preços para o detalhe completo.
Jul 13
- Adicionado um novo
model_typeSmart Topology à API Imagem para 3D, oferecendo dois modelos através deai_model:meshy-t1— o atual modelo low-poly — emeshy-t2— um novo modelo com topology mais limpa, partes separadas nativamente, output em triângulos e uma contagem de faces que pode definir comtarget_polycount. Omeshy-t2é a predefinição emsmart-topology. Omodel_type: lowpolyexistente está agora obsoleto, mas continua a servir tráfego para compatibilidade com versões anteriores.
7 de julho
- Adicionado o parâmetro
aspect_ratioà API Imagem para imagem, permitindo 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; o valor por defeito é1:1, e não pode ser combinado comgenerate_multi_view.
Junho de 2026
17 de junho
- Nova página de documentação API Playground: uma consola interativa para experimentar endpoints sem escrever código, podendo depois copiar o cURL, Python ou JavaScript equivalente. 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évio necessário antes da texturização, ou sempre que precisar de uma disposição UV limpa e sem sobreposições para outras ferramentas. Aceita um
input_task_id(uma tarefa concluída de Imagem para 3D, Texto para 3D ou Remesh) ou ummodel_url(apenas.glb) e devolve um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas com até 40 000 faces (execute primeiro o Remesh se forem maiores); malhas com quads e n-gons são trianguladas durante a geração UV.
Jun 12
- Atualizado o preço de Build da Creative Lab API para 30 créditos por chamada para Keychain, Fridge Magnet e Figure (anteriormente 20). O Lamp mantém-se inalterado em 30 créditos. O preço de Prototype mantém-se inalterado em 6 créditos por imagem. Consulte Pricing para a descrição completa.
Jun 5
- Adicionado o parâmetro opcional
alpha_thumbnailàs APIs Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh e Repair Printability. Quando definido comotrue, a tarefa gera adicionalmente uma versão com fundo transparente (RGBA) da pré-visualização e devolve-a no novo campo de respostaalpha_thumbnail_url. O campo existentethumbnail_urlmantém-se inalterado. O valor predefinido éfalse.
Jun 1
- Novas APIs do Creative Lab: uma família de endpoints específicos 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 — Keychain (porta-chaves), Fridge Magnet (íman de frigorífico), Figure (figura) e Lamp (candeeiro). Cada um segue um fluxo de trabalho em duas fases,
prototype→build, encadeadas através deinput_task_id, disponibilizado sob URLs específicos de produto (/openapi/creative-lab/<product>/v1/...) com versionamento por produto, para que cada produto possa evoluir em linhas de versão independentes. Prototype: 6 créditos por chamada. Build: 30 créditos por chamada.
Maio de 2026
May 26
- Adicionado o parâmetro
multi_view_thumbnailsà API Multi-imagem para 3D. Quando definido comotrue, a tarefa gera adicionalmente quatro miniaturas de vistas cardeais (frente, direita, trás, esquerda) e devolve-as no novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.
May 22
- A funcionalidade de conversão e redimensionamento da API Remesh está agora disponível como endpoints autónomos API Convert e API Resize. Os parâmetros obsoletos na Remesh continuarão a funcionar para compatibilidade retroativa.
May 13
- Adicionado o parâmetro
multi_view_thumbnailsà API Imagem para 3D. Quando definido comotrue, a tarefa gera adicionalmente quatro miniaturas de vistas cardeais (frente, direita, trás, esquerda) e devolve-as no novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.
May 12
- Adicionado o parâmetro
resize_longest_sideà API Remesh. Redimensiona o modelo de forma a que a maior dimensão da caixa delimitadora seja igual ao valor especificado em metros. Mutuamente exclusivo comresize_heighteauto_size.
11 de maio
- Tornou-se obsoleto o parâmetro
symmetry_modenos endpoints Texto para 3D, Imagem para 3D e Multi-imagem para 3D. Este parâmetro deixou de afetar o output.
7 de maio
- Nova API Analisar imprimibilidade: Analisa uma tarefa Meshy bem-sucedida — ou qualquer URL de modelo 3D — quanto à preparação para impressão 3D FDM. Padrão assíncrono de criação + stream: o POST devolve um task_id, e depois o GET / stream SSE devolvem métricas de estanquidade, volume, furos e arestas non-manifold assim que o estado for SUCCEEDED. Gratuito, não consome créditos.
- Nova API Reparar imprimibilidade: Repara um modelo 3D para imprimibilidade FDM — corrige arestas non-manifold, faces degeneradas, furos e outros problemas de topology. Aceita um
input_task_idde uma tarefa Meshy existente ou ummodel_url(.glb,.stl,.obj). O formato do output corresponde ao do input. 10 créditos por tarefa.
Abril 2026
Apr 27
- Adicionado o 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 em tarefas com estadoPENDING,IN_PROGRESSeSUCCEEDED. Devolve0para tarefasFAILED(os créditos são reembolsados automaticamente em caso de falha). Consulte Preços para os custos em créditos por endpoint.
Apr 24
- Adicionado o parâmetro
model_urlao endpoint Multi-Color Print. Submeta diretamente um modelo 3D texturizado (via URL ou Data URI) em vez de uminput_task_idde uma tarefa Meshy anterior. Formatos suportados:.glb,.fbx. Quando são fornecidos tantomodel_urlcomoinput_task_id,input_task_idtem prioridade.
Apr 21
- Adicionado o parâmetro
input_task_idaos endpoints Imagem para 3D e Multi-imagem para 3D. Referencie diretamente o resultado de uma tarefa de Texto para imagem ou Imagem para imagem concluída, em vez de fornecerimage_url/image_urls. Quando ambos são fornecidos,input_task_idtem prioridade.
Apr 20
- Adicionado o parâmetro
hd_textureaos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D Refine e Retexturizar. Quando ativado, a textura de cor base é gerada com resolução 4K (4096×4096) para maior detalhe. Suportado apenas parameshy-6elatest. O valor por defeito éfalse. - O pacote PBR devolvido quando
enable_pbrétrueagora inclui um mapaemissionemtexture_urlspara tarefasmeshy-6elatestnos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D Refine e Retexturizar. Não é necessária qualquer alteração ao pedido.
Apr 14
- Adicionado o parâmetro
decimation_modeaos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D Preview e Remesh. Define o nível de decimação adaptativa da contagem de polígonos:1(ultra),2(alto),3(médio) ou4(baixo).
Apr 12
- Reestruturada a documentação da API: adicionado agrupamento de parâmetros com campos dependentes, valores predefinidos em linha, badges de obrigatório/obsoleto, subnavegação expansível, e separadas as páginas de Multi-Imagem, Rigging e Animação em páginas distintas.
Março de 2026
Apr 2
- Adicionado suporte ao formato
3mfno parâmetrotarget_formatsem todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: o 3MF é apenas opcional e tem de ser explicitamente solicitado. - 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
- Foi descontinuado o modelo de IA Meshy-4. Todos os pedidos de API que utilizem
meshy-4deixaram de ser suportados. Por favor, migre parameshy-6oulatest. - Foram adicionados os parâmetros
auto_sizeeorigin_ataos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D e Remesh. Quandoauto_sizeestá ativado, o serviço utiliza visão por IA para estimar a altura real e redimensionar o modelo automaticamente.origin_atdefine a posição da origem (bottomoucenter). Na API Remesh,auto_sizeé mutuamente exclusivo comresize_height.
Mar 17
- Adicionado o parâmetro opcional
target_formatsaos 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, Texto para 3D Refine e Retexturizar. Remove realces e sombras da textura de cor base para obter resultados mais limpos sob iluminação personalizada. Apenas suportado parameshy-6elatest. O valor predefinido étrue. - As APIs Retexturizar e Texto para 3D Refine suportam agora
meshy-6como valor deai_modelpara texturização completa com o Meshy 6.
Feb 25
- Adicionado o parâmetro
image_enhancementàs APIs de Imagem para 3D e Multi-imagem para 3D para utilizadores que pretendam renunciar à otimização da imagem de entrada e preservar a aparência exata da mesma. Suportado apenas parameshy-6elatest. O valor predefinido étrue.
Feb 20
- Adicionado o parâmetro
model_typeà API de Texto para 3D Preview 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 motivos de falha de tarefas. Isto ajuda os programadores a compreender e tratar melhor os erros da API.
Jan 26
- A API Multi-imagem para 3D agora suporta o Meshy-6 para geração de malha completa. O parâmetro
ai_modelagora aceitameshy-6elatestpassa a resolver para o Meshy 6.
Jan 22
- O parâmetro
art_stylefoi declarado obsoleto para a API de Pré-visualização de Texto para 3D (Meshy-6). O parâmetro foi concebido para os modelos Legacy (Meshy-4 / Meshy-5) e será removido numa versão futura. - O parâmetro
enable_pbrfoi declarado obsoleto para as APIs de Texto para 3D e Imagem para 3D quandoai_modelémeshy-4. Este parâmetro será removido numa versão futura. - Foi atualizado o valor predefinido do parâmetro
should_remeshpara o Meshy-6 nas APIs de Texto para 3D e Imagem para 3D. O parâmetro passa agora a ter como predefiniçãofalseparameshy-6, etruepara os restantes modelos, caso não seja especificado.
19 jan
- A opção
latestparaai_modelnas APIs de Texto para 3D (Preview) e Imagem para 3D resolve agora para Meshy 6.
12 jan
- Adicionado um novo parâmetro
model_typeà API de Imagem para 3D para gerar malhas low-poly otimizadas para polígonos mais limpos.
Dezembro de 2025
31 dez
- Lançado o API Playground, um espaço dedicado para os programadores explorarem parâmetros de API e testarem pedidos diretamente no site da Meshy.
- Introduzidas a API Texto para Imagem e a API Imagem para Imagem, permitindo a geração de imagens com recurso a IA a partir de instruções de texto e a 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 Texto para 3D está agora obsoleto e será removido numa versão futura.
Dec 04
- Foi adicionado um novo parâmetro
pose_modeàs APIs Text to 3D Preview, Imagem para 3D e Multi-imagem para 3D. Este parâmetro aceitaa-pose,t-pose, ou uma cadeia vazia (predefinição). O parâmetrois_a_t_poseestá agora obsoleto, sendo substituído porpose_mode.
Novembro de 2025
Nov 24
- As APIs de Imagem para 3D e Multi-imagem para 3D adicionam um parâmetro opcional
save_pre_remeshed_modele expõemmodel_urls.pre_remeshed_glbquando é solicitada uma cópia de segurança antes do remesh.
Nov 06
- A API de Refine de Texto para 3D agora suporta
ai_model = latest, que resolve para Meshy 6 Preview. - A API de Imagem para 3D agora usa por predefinição a texturização Meshy-6-preview quando
ai_model = latesteshould_texture = true. - A API de Multi-imagem para 3D agora suporta
ai_model = latest, executando o Meshy-6-preview para texturização por predefinição, enquanto a geração de malha permanece em Meshy-5. - A API de Retexturizar adiciona uma opção
latestparaai_model(Meshy-6-preview) e agora usa-a por predefinição quando omitida.
Nov 04
- A API Remesh agora preserva as texturas de modelos carregados.
- A API Retexture agora preserva as texturas de 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à API Remesh para suportar a conversão apenas do formato do ficheiro de modelo de entrada. - Adicionado
rigged_character_glb_urlà resposta do The Rigging Task Object.
Oct 01
- Remoção das APIs
text-to-voxel
Setembro de 2025
Sep 23
- Adicionada uma opção
latestparaai_modelna API Texto para 3D para utilizar o Meshy 6 Preview. - Desconto temporário de 50% em vigor para as tarefas de geração Meshy-6-preview, reduzindo-as 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 valor normal de 20 créditos.
Sep 18
- Atualizados os preços da API para Texto para 3D e Imagem para 3D para refletir os diferentes custos do Meshy 6 e de outros modelos.
Sep 16
- Adicionada uma opção
latestparaai_modelna API Image to 3D para usar o Meshy 6 Preview.
Sep 4
- Alargado o suporte de entrada de
model_urlpara.glb,.gltf,.obj,.fbx,.stlem Remesh e Retexture.
Agosto de 2025
Aug 18
- Adicionado um parâmetro opcional
is_a_t_poseàs APIs Text to 3D Preview, Image to 3D e Multi-Image to 3D para gerar modelos numa pose A/T.
Aug 13
- O Meshy 5 já está estável para Texto para 3D e Imagem para 3D (
ai_model:meshy-5), proporcionando maior qualidade e consistência.
Julho de 2025
Jul 31
- Suporte para mapas de textura PBR na API através do parâmetro
enable_pbrpara o modelo mais recentemeshy-5, disponível nos endpoints Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar.
Junho 2025
Jun 25
- Adicionada a API de Retexturizar, que permite aos utilizadores retexturizar modelos 3D com base nos mais recentes modelos de IA fundamentais 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 Refine de Texto para 3D.
Jun 17
- Adicionada documentação para Webhooks.
Jun 10
- A Remesh API agora suporta modelos no formato GLB codificados em base64 no parâmetro
model_urlatravés de Data URI.
May 2025
May 20
- Adicionado um parâmetro
moderationopcional às APIs Text to 3D Preview, Text to 3D Refine, Image to 3D e Multi-Image to 3D. Quando ativado, o conteúdo introduzido é automaticamente analisado em busca de conteúdo potencialmente prejudicial antes da geração.
15 de maio
- Introdução da API de Rigging e Animação automáticos, permitindo aos utilizadores aplicar rigging e animar modelos 3D automaticamente. Saiba mais sobre Rigging e Animação.
abril de 2025
29 de abril
- Introdução da API Multi-imagem para 3D, que permite gerar modelos 3D a partir de 1 a 4 imagens de entrada utilizando o modelo de IA
meshy-5. - Adicionada a opção do modelo de IA
meshy-5às APIs Texto para 3D e Imagem para 3D. A etiquetalatestpassa agora também a corresponder aomeshy-5.
Apr 17
- Adicionado o parâmetro
texture_image_urlàs APIs Imagem para 3D e Texto para 3D Refine, permitindo aos utilizadores orientar o processo de geração de textura com uma imagem.
March 2025
Mar 28
- Adicionado o parâmetro
latestàs APIs Texto para 3D e Imagem para 3D, permitindo o acesso aos nossos futuros modelos de IA avançados para uma qualidade de geração melhorada.
Mar 14
- A API de Texto para textura agora suporta modelos codificados em base64 no parâmetro
model_urlatravés de Data URI, de forma semelhante aoimage_urlna API Imagem para 3D.
Mar 06
- Preços atualizados para as tarefas de geração via 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: Mantém-se em 5 créditos por chamada
Fevereiro 2025
Feb 18
- Adicionada uma chave de API do modo de teste 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 tarefas de amostra.
Feb 13
-
Alterações significativas:
- A criação de tarefas no nível gratuito terminará a
March 20, 2025. Depois dessa data, todos os pedidos de tarefas da API exigirão uma subscrição paga. Para manter o seu acesso sem interrupções, recomendamos que atualize antes do prazo. - Utilize o código de cupão
APIACCESSpara usufruir de um desconto de40%. Obrigado por estar connosco!
- A criação de tarefas no nível gratuito terminará a
-
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 Texto para 3D Refine, permitindo aos utilizadores guiar o processo de geração de textura com um prompt de texto.
January 2025
Jan 23
- Adicionados endpoints para listar tarefas às APIs Texto para 3D, Imagem para 3D, Remesh e Texto para textura.
Jan 14
- Obsoleto as APIs legadas 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 Text to 3D Preview e Image to 3D, permitindo configurar definições de simetria.
Dezembro de 2024
Dec 19
- Adicionadas as APIs de Remesh, que permitem aos utilizadores remesh 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
- Obsoleta a propriedade
model_urlem todos os objetos de resposta. - Separada a API Legacy Meshy-3 da mais recente API Meshy-4.
Dec 10
- Adicionado o parâmetro
enable_pbràs APIs Imagem para 3D e Text to 3D Refine. - Adicionado o parâmetro
should_textureà API Imagem para 3D. - Obsoleta a opção
pbrno parâmetroart_stylepara a API Text to 3D Preview ao utilizar o modelo de IAmeshy-4. - Obsoleta a opção
low-polyno parâmetroart_stylepara a API Text to 3D Preview.
Dec 5
- Adicionada uma Get Balance API para permitir que os utilizadores consultem o seu saldo de créditos.
- Adicionado um parâmetro
should_remeshàs APIs Imagem para 3D e Text to 3D Preview.
Dec 3
- As APIs externas utilizam agora o prefixo
/openapi. Os caminhos Legacy continuam a ser suportados, mas recomendamos a mudança para os novos caminhos.
November 2024
Nov 14
- A Image to 3D API suporta agora imagens codificadas em base64.