Registro de alterações
Veja todos os recursos e atualizações mais recentes da Meshy API e dos plugins.
Prefere um feed ao vivo? As entradas mais recentes também aparecem na página de visão geral da Plataforma para Desenvolvedores.
Novembro de 2026
Nov 18
- Adicionado rigging de quadrúpede ao Rigging. Envie
animation_type: "quadruped"para fazer o rigging de um animal de quatro patas. O rig vem com uma animação de caminhada e uma de corrida. - Animação aplica animações
quadrupeda um rig de quadrúpede, comaction_idouaction_ids. Qualquer animaçãoquadrupedfunciona em qualquer rig de quadrúpede. Um rig de quadrúpede e cada animação custam o mesmo que em um rig de bípede. - List animations retorna
rig_typeem cada animação,bipedouquadruped. Um rig aceita apenas animações do seu próprio tipo.
Nov 16
- Adicionados
color_mappingetarget_formatsà API de Relevo.color_mapping: truecolore os arquivos GLB, OBJ, FBX e USDZ com a foto, etarget_formatsadiciona arquivos OBJ, FBX, USDZ e 3MF. O preço permanece em 20 créditos.
Nov 13
- Nova página do Meshy CLI: instale o comando
meshy, faça login pelo navegador (ou com um código de dispositivo em uma máquina remota) e gere seu primeiro modelo commeshy make. Ela também aborda a saída em JSON e códigos de saída para scripts, um exemplo com GitHub Actions, e quando usar o CLI ou o MCP server, que a Integração de IA agora compara.
10 de nov
- Adicionado
skeleton_templateao Rigging. Ele entrega um personagem bípede no esqueleto esperado pelo seu engine ou ferramenta, comomixamoouue5_mannequin. As tarefas de Animação usam o esqueleto do rig. O v1 do Rigging usameshyrigpor padrão, como antes, e o v2 do Rigging usamixamopor padrão. - Adicionado
include_fingersao Rigging. Defina comotruepara adicionar ossos dos dedos às mãos de um personagem bípede, em qualquer esqueleto. meshy-7será desativado em 31 de dezembro de 2026 como oai_modeldas tarefas de preview de Texto para 3D, Imagem para 3D e Multi-imagem para 3D. A partir dessa data, requisições que enviaremai_model: "meshy-7"para esses endpoints retornarão400. Mude parameshy-7.1, que aceita os mesmos parâmetros e custa o mesmo. Omeshy-7como modelo de textura continua disponível. Isso abrange Retexturizar,texture_modele oai_modelde um refine de Texto para 3D. Veja Descontinuações.
Nov 6
- Adicionados
gpt-image-2-6-flareegpt-image-2-6-sunburstaos valores deai_modeldas APIs Texto para imagem e Imagem para imagem. Esses são os níveis do OpenAI GPT Image 2.6: Flare para iteração rápida, Sunburst para trabalhos detalhados e edições precisas. Eles aceitam as mesmas proporções de aspecto que os outros modelos GPT Image e custam o mesmo quegpt-image-2(Texto para imagem: 9 créditos; Imagem para imagem: 12 créditos).
5 de novembro
- Nova API de Relevo: transforma uma foto em um modelo 3D em baixo-relevo (GLB e STL) e um mapa de profundidade em escala de cinza de 16 bits, para impressão 3D, gravação a laser e usinagem CNC. Parâmetros opcionais definem o tamanho, o mode e a profundidade de gravação, a base, a curvatura e a resolução da malha, e
should_generate_model: falseretorna apenas o mapa de profundidade. 20 créditos por tarefa.
3 de novembro
- Adicionado
texture_modela Imagem para 3D e Multi-imagem para 3D, para que você escolha o modelo de textura na mesma tarefa da malha. Imagem para 3D aceita Meshy 7 (meshy-7), Meshy N1 (meshy-n1) e Meshy 6 Lite (meshy-6-lite) com qualquerai_model. Multi-imagem para 3D aceita os modelos de textura multivista, Meshy 7 e Meshy N1. Cada modelo de textura mantém seus próprios limites; veja Modelos. Uma tarefa custa o preço apenas da malha do seuai_modelmais o preço do Retexturizar na sua resolução de textura; veja Preços. Solicitações semtexture_modelfuncionam como antes. - Adicionado
ai_model: "meshy-n1"ao refine de Texto para 3D. Semtexture_image_url, o Meshy N1 aplica texturas a partir da imagem de referência que um preview do Meshy 7.1 oulatestarmazena. Outros previews precisam detexture_image_url. Um refine com Meshy N1 custa 10 créditos.
Nov 2
- Adicionado
ai_model: "meshy-n1"à API de Retexturizar. O Meshy N1 cria uma textura de cor base em 2K a partir de uma a quatro imagens de referência. Com mais de uma imagem, a primeira é a vista frontal, e a ordem das demais não importa, assim como no Meshy 7. Ele não aceita prompt de texto, não gera mapas PBR nem texturas em 4K e 8K, e texturiza modelos 3D com até 7.999.999 faces. Uma tarefa custa 10 créditos, o mesmo valor de um Retexturizar em 2K; veja Preços.latestainda corresponde ao Meshy 7.
Outubro de 2026
Oct 30
- Algumas requisições do Meshy T1 (
model_type: "lowpoly"ouai_model: "meshy-t1") em Texto para 3D e Imagem para 3D agora rodam no Smart Topology, e as demais retornam400.model_type: "smart-topology"comai_model: "meshy-t2.5"substitui o T1. A partir de 30 de novembro de 2026, toda requisição T1 retornará400. Deprecations lista quais requisições ainda funcionam. - A API do Auto Split tem um novo parâmetro opcional,
keep_texture. Comkeep_texture: true, cada parte de um modelo texturizado mantém a textura, e a tarefa retorna os mapas de textura emtexture_urls, além de um arquivomtlcom um OBJ. Sem ele, a divisão funciona como antes. Uma divisão que mantém a textura leva cerca do dobro do tempo e ainda custa 10 créditos.input_task_idtambém aceita tarefas de refine de Texto para 3D e de Retexturizar.
Oct 26
- Nova página de Obsolescências: o ciclo de vida de cada modelo de geração 3D (ativo, legado, obsoleto ou retirado) com sua data de retirada e substituição recomendada, o histórico de cada obsolescência de API, e os parâmetros obsoletos que ainda estão em uso. O banner de retirada nas páginas da API agora tem um link para ela.
Oct 23
texture_image_urltornado obsoleto em Rigging. O Meshy usa as texturas incorporadas no arquivomodel_url, ou as texturas da tarefa de entrada, então deixe-o de fora quando o modelo já tiver suas próprias texturas. Se você enviá-lo, a imagem se torna a única textura do modelo com rig, e o modelo perde seus mapas PBR.
Oct 21
- Adicionado o cabeçalho
X-Meshy-Metadatapara equipes Studio e Enterprise em todo endpoint que cria uma tarefa, exceto endpoints do Creative Lab. Marque uma tarefa com seus próprios pares chave-valor, comouser=alex@example.com,team=fab, e leia-os de volta no campometadatados registros de Usage. Veja Metadata.
Oct 19
export_resolutionagora aceita valores de até512, reduzido de2048, nas tarefas de build de Keychain e ímã de geladeira.512é a resolução do mapa de profundidade a partir do qual a geometria é construída, então todo valor acima dele posicionava vértices extras entre amostras que já existiam, gerando um arquivo maior que descreve a mesma superfície.512também é o valor padrão, então chamadas que nunca definemexport_resolutionnão são afetadas. Um valor acima de512agora retorna400no momento da criação, em vez de ser aceito.2048em particular sempre ultrapassava o prazo do gerador e falhava depois que a tarefa já havia iniciado. Se você definirexport_resolutionacima de512, remova o parâmetro ou defina-o como512.
Oct 15
- Adicionado
ai_model: "meshy-t2.5"às APIs Imagem para 3D e Texto para 3D: o modelo Smart Topology mais recente, com detalhes mais nítidos para assets de jogos. Use-o commodel_type: "smart-topology"; a saída é somente triângulos, etarget_polycountaceita de 100 a 30.000 (padrão 15.000). O preço é o mesmo demeshy-t2; veja Preços. Ele agora é o padrão quandomodel_type: "smart-topology"é definido semai_model; definaai_model: "meshy-t2"para continuar usando o Meshy T2. O Multi-imagem para 3D não oferece suporte ameshy-t2.5.
14 de out
model_urlagora aceita arquivos de até 400 MB, acima dos 100 MB anteriores, quando é uma URLhttpouhttps, em Retexturizar, Remesh, Rigging, Converter, Redimensionar, Desdobramento UV, Multi-Color Print, Analisar imprimibilidade e Reparar imprimibilidade. Um URIdata:permanece em 100 MB. Um arquivo GLB, glTF, FBX ou OBJ acima de 100 MB pode ter no máximo 10.000.000 de faces (8.000.000 para Multi-Color Print), contadas como triângulos; um arquivo com mais faces retorna400. Acima de 100 MB, um arquivo FBX deve ser FBX binário 7.1 ou mais recente, e um arquivo GLB ou glTF não pode usar compressão Draco. O arquivo é baixado antes que a requisição de criação retorne, então reserve até 120 segundos para um arquivo grande (veja Ciclo de Vida da Tarefa). Arquivos de 100 MB ou menos se comportam como antes, e os preços permanecem inalterados.- Analisar imprimibilidade agora responde com
404e o mesmo corpo de um id inexistente quando uminput_task_idpertence a outra conta, em vez de403. Uma tarefa sua, ou de um colega de equipe em um espaço de trabalho ao qual você pertence, funciona como antes.
Oct 12
- Os arquivos USDZ agora usam metros, de modo que os modelos abrem em seu tamanho real no AR Quick Look, Reality Composer, Blender e outros visualizadores USD. O arquivo
usdzemmodel_urlsdas tarefas de Texto para 3D, Imagem para 3D, Multi-imagem para 3D, Retexturizar, Remesh, Converter, Redimensionar e Auto Split agora declarametersPerUnit = 1. Até agora, ele declarava pés (metersPerUnit = 0.3048) enquanto suas coordenadas estavam em metros, fazendo com que o modelo aparecesse a 30,48% do seu tamanho. Se você escalar os arquivos USDZ por 3,28 para compensar, remova essa escala para as tarefas criadas a partir desta data. Os arquivos de tarefas anteriores mantêm sua unidade atual, e os arquivos USDZ de Rigging e Animação não são afetados.
Oct 10
meshy-5foi descontinuado. Requisições que enviamai_model: "meshy-5"para Text to 3D, Image to 3D, Multi-Image to 3D ou Retexture agora retornam400com a mensagemai_model meshy-5 has been retired; use meshy-6-lite. Mude parameshy-6-lite, que aceita os mesmos parâmetros pelo mesmo custo em créditos. Modelos que você já gerou commeshy-5continuam disponíveis, e fazer o refine de uma preview domeshy-5sem definirai_modelcontinua funcionando..webpagora está documentado como um formato de imagem de entrada suportado, junto com.jpg,.jpege.png, em Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) e Text to 3D Refine (texture_image_url). Funciona tanto para URLs públicas quanto para data URIs (data:image/webp;base64,...). Integrações existentes não são afetadas, e os preços permanecem inalterados.- Get Balance agora também retorna
monthly_credits,permanent_creditsemonthly_resets_at, para que você possa ver quanto do seu saldo expira na próxima renovação. Obalanceem si permanece inalterado.
Oct 6
- Analisar imprimibilidade e Reparar imprimibilidade agora podem verificar a espessura de parede no tamanho em que você planeja imprimir. Envie
printer_type, um tamanho de impressão ou ambos. Analisar imprimibilidade informa paredes finas emprintability.thin_walls, e Reparar imprimibilidade as espessa quando necessário, podendo reutilizar a impressora e o tamanho de uma tarefa de análise passada comoinput_task_id. Integrações que não usam esses campos se comportam como antes, e os preços permanecem inalterados.
Setembro de 2026
Sep 29
- O caminho legado
/v2/text-to-3d(sem o prefixo/openapi) está obsoleto. Ele continua funcionando sem alterações por enquanto, mas será removido em uma versão futura. Mude para/openapi/v2/text-to-3d, que recebe a mesma requisição e retorna a mesma resposta. As respostas no caminho legado agora incluem um cabeçalhoDeprecatione um cabeçalhoLinkapontando para o novo caminho.
Sep 28
- As respostas da API agora incluem cabeçalhos de limite de taxa, incluindo
Retry-Afterpara indicar quanto tempo esperar antes de tentar novamente ou fazer nova consulta. - Multi-Color Print agora aceita um novo parâmetro
printer_brandque grava um preset de fatiador correspondente no 3MF, de modo que o arquivo abra pronto para impressão em impressoras Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker e AnkerMake, além da Bambu Lab (o padrão). A página agora também documentamax_depth.
18 de setembro
- 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 demeshy-7, com maior detalhamento de geometria.latestagora é resolvido parameshy-7.1;meshy-7está obsoleto, mas continua funcionando sem alterações. - Adicionado
geometry_resolution(standard/2k/4k) às mesmas APIs, substituindo o agora obsoletoultra_mode(ultra_mode: trueainda funciona 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 extras que2k.
16 de setembro
- A API do Auto Split agora aceita um
input_task_idtexturizado. Anteriormente, ela rejeitava um com400, o que significava gerar a mesma malha uma segunda vez comshould_texture: falsepara dividi-la. Uma divisão corta a geometria e reconstrói as superfícies de cada parte, então a textura da entrada não é transferida e o resultado é um modelo sem textura com uma cor plana por parte. Isso já era verdade para toda divisão e permanece inalterado. meshy-5será descontinuado em 10 de outubro de 2026. Ele não está mais documentado como um valor deai_modelpara Texto para 3D, Imagem para 3D, Multi-imagem para 3D ou Retexturizar, e após 10 de outubro, solicitações que enviaremai_model: "meshy-5"retornarão um erro.- A chave de API de modo de teste compartilhada foi descontinuada; solicitações que ainda a enviam agora retornam
401 Unauthorized. Se você a copiou para código ou CI, substitua-a pela sua própria chave na página de Chaves de API. Essa chave sempre retornava o mesmo modelo de amostra independentemente da entrada, então ela nunca mostrava o que uma solicitação realmente geraria. Para ver o que a API retorna antes de construir algo em cima dela, use o Playground na Developer Platform, que executa uma tarefa real no seu navegador. Em planos sem acesso à API, ele executa Imagem para 3D sem uma chave de API e usa 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 de Texto para imagem e Imagem para imagem. Esses são os 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 de Texto para imagem e Imagem para imagem, além de1:1,16:9,9:16,3:2e2:3.
Sep 14
- A API de Imagem para imagem agora aceita
input_task_id, então você pode encadear diretamente a partir de uma tarefa de Texto para imagem ou Imagem para imagem já concluída, em vez de copiar as URLs de saída dela parareference_image_urls.
Sep 11
- Mudança de comportamento:
DELETEem uma tarefa que já estáIN_PROGRESSagora é rejeitado com409 Conflict, e a tarefa continua em execução. Anteriormente, isso retornava200 OK, interrompia o worker e descartava o resultado, mas mantinha os créditos, pois apenas tarefasPENDINGsão reembolsáveis. A chamada custava tanto o modelo quanto os créditos, sem nada na resposta que indicasse isso. Se sua integração exclui tarefas para cancelá-las, observe que uma tarefa que o worker já iniciou não pode ser cancelada. Aguarde atéSUCCEEDED,FAILEDouCANCELEDe então a exclua. TarefasPENDINGainda são excluídas e reembolsadas exatamente como antes, e tarefas em estado terminal também continuam sendo excluídas. Aplica-se a todas as famílias de tarefas sob/openapi. Veja Erros. - Adicionado
meshy-6-liteaos valores documentados deai_modelpara as APIs de Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar. Ele é o sucessor domeshy-5: mesmos parâmetros, mesmo custo em créditos (5 para a malha, 15 com textura, 10 para uma retexturização). meshy-5agora está obsoleto em todas as APIs que o aceitam. Ele continua funcionando e nada muda em sua requisição ou em sua cobrança, mas deixará de aceitar novo tráfego em uma versão futura. Se sua integração enviaai_model: "meshy-5", migre parameshy-6-lite.
Sep 9
- Nova Auto Split API: Divide um modelo sem textura do Meshy 6 ou Meshy 7 em partes imprimíveis separadamente. A divisão é feita automaticamente, pelas partes que você nomear (
by_parts), ou por região de cor (by_color), com conectores de encaixe macho-fêmea opcionais e reforço de parede fina. Exporta cada parte como um objeto separado emglb,obj,fbx,usdz,blendou3mf, seja montado ou disposto na plataforma de impressão (layout). 10 créditos por tarefa.
Sep 7
- Adicionado o parâmetro
name_textao estágio de protótipo da Creative Lab Keychain API: grave um nome de até 10 caracteres no chaveiro, a mesma personalização oferecida pelo aplicativo web. O estágio de construção herda a gravação automaticamente, e o objeto da tarefa de protótipo agora retornaname_textpara que você possa confirmar o texto exato antes da construção.namecontinua sendo apenas um rótulo de exibição da tarefa e não é gravado.
5 de set
- Adicionada a API do Creative Lab Fidget Pixel: transforma uma foto em uma plaquinha fidget de pixel art multicolorida e imprimível em 3D, em duas etapas.
POST /prototype(6 créditos) pixeliza a foto em uma imagem de pixel art. Informetypecomopersonouotherpara escolher o estilo de pixelização.POST /build(30 créditos) amostra a imagem em uma grade16ou32e transforma cada pixel em uma peçasquareouhexencaixável, entregue como um único arquivo 3MF com marcação de cores para impressão com múltiplos filamentos. A geometria das peças é ajustável compiece_size_mm,color_countepiece_height_mm.
Sep 4
- Adicionado
GET /openapi/v1/animations/libraryà Biblioteca de animações: obtenha todas as ações predefinidas aceitas pela Animation API (action_id, nome, categoria e uma prévia em GIF animado) com filtros de busca e categoria, para que você possa construir 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 foto em um fidget toy colapsável pronto para impressão, em que a silhueta do sujeito se torna anéis concêntricos aninhados que se achatam ao colapsar e se esticam novamente, impressos em uma única peça sem necessidade de montagem. Um único
POSTleva a imagem até o modelo finalizado. Não há par de etapas prototype/build nem parâmetros de geometria para ajustar. Cada tarefa custa 6 créditos e retorna um STL imprimível, além de um GLB para pré-visualização quando o Meshy conseguir renderizá-lo.
Sep 3
- O estágio de protótipo da Creative Lab Lamp API agora retorna um modelo 3D.
POST /prototypetransforma a imagem conceitual em um GLB de abajur oco, e o objeto de tarefa de protótipo ganhamodel_urls.glbethumbnail_urlao lado deimage_urls. O estágio de build executa apenas o processador de luminária nesse modelo e agora produz um abajur de fundo aberto com uma placa de base para o acessório da fonte de luz. Os preços acompanham o trabalho. O protótipo custa 30 créditos e o build 6 créditos (anteriormente 6 e 30). O parâmetrotextdo protótipo foi removido, eimage_urlagora é obrigatório.
Sep 2
- A Animation API agora aceita
action_ids, permitindo aplicar até 10 ações predefinidas a um personagem com rig em uma única solicitação e receber um arquivo único contendo um clipe de animação por ação, pronto para ser usado a partir de uma máquina de estados em um motor de jogo. Os clipes mantêm a ordem em que foram listados e carregam o nome da biblioteca da animação. O custo é de 3 créditos por ação, epost_processse aplica ao arquivo mesclado. Consulte a Referência da Biblioteca de animações para ver os ids disponíveis e a tabela de preços.
Sep 1
- Adicionado o parâmetro
ultra_modeà API de Multi-imagem para 3D: habilita a geração Ultra noai_modelmeshy-7(oulatest) para uma geometria de maior fidelidade com detalhes de superfície mais refinados, por 5 créditos extras. É o mesmo processo Ultra oferecido pela API de Imagem para 3D, agora disponível com entradas em multivista. - Removido
meshy-t1dos valores deai_modeldocumentados para omodel_typeSmart Topology da API de Imagem para 3D. O Smart Topology agora documenta apenasmeshy-t2; novas integrações devem usá-lo em seu lugar. O Meshy T1 está planejado para ser descontinuado. Se sua integração atualmente enviaai_model: "meshy-t1", migre parameshy-t2.
Agosto de 2026
Aug 28
- Adicionada a Usage API para equipes Studio e Enterprise: exporte programaticamente o histórico de uso de tarefas da API (endpoint, status, timestamps, a chave de API que executou cada tarefa e
consumed_credits) com paginação padrão e filtros de janela de tempo, endpoint e status, para rastreamento de custos e sistemas financeiros.
Aug 26
- A Animation API agora aceita
motion_task_id, para que você possa aplicar um clipe de movimento gerado com a Text to Motion API ao seu personagem bípede com rig, como alternativa a umaction_idpredefinido. Mesmo custo de 3 créditos por tarefa.
Aug 24
- Suporte expandido para
aspect_rationogpt-image-2nas APIs de Texto para imagem e Imagem para imagem para adicionar16:9e9:16. Ogpt-image-2agora aceita1:1,16:9,9:16,3:2e2:3;4:3e3:4permanecem sem suporte para esse modelo.
Aug 21
- Adicionada a API Text to Motion: 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ção de clipes de 2 a 10 segundos.
Aug 20
- Adicionado o parâmetro
styleà Multi-Color Print API: escolharealistic(padrão) para cores fiéis à textura, oucartoonpara regiões de cor plana e uniforme e um 3MF menor. - 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.
Aug 18
- Adicionado o parâmetro
texture_image_urlsà API de Multi-imagem para 3D: forneça de 1 a 4 imagens do mesmo objeto para guiar a texturização, em vez do únicotexture_image_url. Requerai_modelmeshy-7oulatest, e é independente deimage_urls. As duas listas podem conter imagens diferentes e quantidades diferentes de imagens.
Aug 17
- Adicionado o parâmetro
remove_backgroundà API de Texto para imagem e à API de Imagem para imagem. Definaremove_background: truepara receber a imagem gerada como um PNG RGBA transparente com o fundo removido.
13 de ago
- Adicionado
ai_model: "meshy-7"à API de Texto para 3D: nosso mais novo modelo de geração 3D, com geometria de maior fidelidade do que o Meshy 6. Ele também introduz o parâmetroultra_modena tarefa de preview, que habilita a geração Ultra para um detalhamento de superfície ainda mais refinado por 5 créditos extras. Para texturizar com o Meshy 7, passeai_model: "meshy-7"na tarefa de refine ou omitaai_modelcompletamente. - 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 você pode definir comtarget_polycount(100 a 15.000, padrão 4.000). Um preview de Smart Topology custa 5 créditos em vez de 20; veja Preços. Omodel_type: "lowpoly"existente agora está obsoleto, mas continua atendendo o tráfego por compatibilidade com versões anteriores.
12 de ago
- Adicionado
ai_model: "meshy-7"à API de Imagem para 3D: nosso mais novo modelo de geração 3D, com geometria de fidelidade mais alta do que o Meshy 6. Ele também introduz o parâmetroultra_mode, que ativa a geração Ultra para detalhes de superfície ainda mais refinados. - Adicionado
ai_model: "meshy-7"à API de Multi-imagem para 3D: o modelo de geração multivista do Meshy, que se condiciona em todas as suas vistas de entrada em conjunto e conduz a texturização a partir delas. - Adicionado
ai_model: "meshy-7"à API de Retexturizar: nosso mais novo modelo de texturização, com detalhes de superfície mais nítidos e materiais PBR mais limpos do que o Meshy 6. Ele também introduz o parâmetromultiview_image_urls. Forneça de 1 a 4 vistas ordenadas do mesmo objeto para conduzir a texturização multivista.
4 de Agosto
- Suporte expandido de entrada
model_urlpara.glb,.gltf,.obj,.fbx,.stlnos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente.glb,.stl,.obj). O reparo retorna o asset reparado no formato de entrada original.
Julho de 2026
27 de Jul
- Novo Creative Lab Brick Figure API: transforma uma foto em uma minifigura 3D colecionável no estilo de blocos. Ele usa o mesmo fluxo de trabalho em duas etapas da Figure API.
prototype(6 créditos) gera uma imagem conceitual estilizada, ebuild(30 créditos) a transforma em um modelo 3D texturizado com saídas em GLB e OBJ + MTL. Veja Preços para o detalhamento completo.
Jul 22
- Nova API de Keycap do Creative Lab: transforme uma foto em uma keycap personalizada de teclado mecânico, em cores completas. Ela utiliza um fluxo de trabalho em dois estágios.
prototype(12 créditos) gera uma renderização do design final da keycap, e entãobuild(50 créditos) transforma o design escolhido (comcandidate_id) em um modelo 3D de keycap texturizado, com saídas em pacote GLB e OBJ, exportado em escala real de milímetros. Atualmente suporta a base padrão Cherry MX 1u (cherry-mx-1x1-r1); mais tamanhos padrão estão planejados. Consulte Preços para o detalhamento completo.
Jul 21
- Agora oferecemos suporte a texturas de cor base em 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 em 4K e nenhum mapa de emissão é produzido. A geração de textura em 8K custa 15 créditos (2k/4kpermanecem em 10). Consulte Preços. - O booleano
hd_textureestá obsoleto em favor detexture_resolution. Ele ainda é respeitado e equivale atexture_resolution: "4k"para compatibilidade com versões anteriores.
Jul 20
- Nova API Creative Lab Vinyl Figure: transforma uma foto em uma figura 3D colecionável de vinil estilo cabeçudo. Ela usa o mesmo fluxo de trabalho em duas etapas da API Figure.
prototype(6 créditos) gera uma imagem conceitual estilizada, ebuild(30 créditos) a transforma em um modelo 3D texturizado com saídas em GLB e OBJ + MTL. Consulte Preços para o detalhamento completo.
Jul 13
- Adicionado um novo
model_typeSmart Topology à API Imagem para 3D, oferecendo dois modelos por meio deai_model:meshy-t1(o modelo low-poly atual) emeshy-t2(um novo modelo com topology mais limpa, partes nativamente separadas, saída em triângulos e uma contagem de faces que você pode definir comtarget_polycount).meshy-t2é o padrão emsmart-topology. Omodel_type: lowpolyexistente agora está obsoleto, mas continua atendendo o tráfego para compatibilidade com versões anteriores.
Jul 7
- Adicionado o parâmetro
aspect_ratioà API Imagem para imagem, 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; o padrão é1:1e não pode ser combinado comgenerate_multi_view.
Junho de 2026
Jun 17
- Nova página de documentação do API Playground: um console interativo para testar endpoints sem escrever código e, em seguida, copiar o cURL, Python ou JavaScript equivalente. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.
15 de Jun
- Novo API de Desdobramento UV: gera 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ções para ferramentas posteriores). Aceita um
input_task_id(uma tarefa concluída de Imagem para 3D, Texto para 3D ou Remesh) ou umamodel_url(apenas.glb) e retorna um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta meshes com até 40.000 faces (execute o Remesh primeiro se for maior); meshes com quads e n-gons são triangulados durante a geração do UV.
Jun 12
- Atualizado o preço do Build da Creative Lab API para 30 créditos por chamada para Keychain, Fridge Magnet e Figure (anteriormente 20). Lamp permanece inalterado em 30 créditos. O preço do Prototype permanece inalterado em 6 créditos por imagem. Consulte Preços para o detalhamento completo.
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 renderiza adicionalmente uma versão com fundo transparente (RGBA) da pré-visualização e a retorna no novo campo de respostaalpha_thumbnail_url. O campothumbnail_urlexistente permanece inalterado. O padrão éfalse.
Jun 1
- Novas Creative Lab APIs: uma família de endpoints com escopo de produto que transformam uma foto de origem (ou prompt de texto) em um produto de consumo pronto para impressão 3D. Quatro produtos no lançamento: chaveiro, ímã de geladeira, figura e luminária. Cada um segue um fluxo de trabalho em dois estágios,
prototype→build, encadeado por meio deinput_task_id, disponibilizado sob URLs com escopo 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 renderiza adicionalmente quatro thumbnails de vistas cardeais (frente, direita, trás, esquerda) e os retorna no novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Isso adiciona aproximadamente 3 segundos à latência da tarefa.
May 22
- As funcionalidades de conversão e redimensionamento da API Remesh agora estão disponíveis como endpoints independentes API Convert e API Resize. Os parâmetros obsoletos no Remesh continuarão funcionando para retrocompatibilidade.
13 de maio
- Adicionado o parâmetro
multi_view_thumbnailsà API Imagem para 3D. Quando definido comotrue, a tarefa renderiza adicionalmente quatro miniaturas de visualização cardinal (frontal, direita, traseira, esquerda) e as retorna no novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.
12 de maio
- Adicionado o parâmetro
resize_longest_sideà API Remesh. Redimensiona o modelo para que a maior dimensão da caixa delimitadora seja igual ao valor especificado em metros. É mutuamente exclusivo comresize_heighteauto_size.
11 de maio
- O parâmetro
symmetry_modefoi tornado obsoleto nos endpoints Texto para 3D, Imagem para 3D e Multi-imagem para 3D. Esse parâmetro não afeta mais o resultado.
7 de maio
- Nova API Analisar imprimibilidade: Analisa uma tarefa Meshy bem-sucedida, ou qualquer URL de modelo 3D, quanto à prontidão para impressão 3D FDM. Padrão de criação assíncrona + stream: POST retorna um task_id, e então GET / stream SSE retornam métricas de estanqueidade (watertightness), volume, furos e arestas non-manifold quando SUCCEEDED. Gratuito, não consome créditos.
- Nova API Reparar imprimibilidade: Repara um modelo 3D para imprimibilidade FDM, corrigindo arestas non-manifold, faces degeneradas, furos e outros problemas de topology. Aceita um
input_task_idexistente da Meshy ou ummodel_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_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 statusPENDING,IN_PROGRESSeSUCCEEDED. Retorna0para 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. Envie um modelo 3D texturizado diretamente (com uma URL ou Data URI) em vez de uminput_task_idde uma tarefa anterior do Meshy. Formatos suportados:.glb,.fbx. Quando tantomodel_urlquantoinput_task_idsão fornecidos,input_task_idtem prioridade.
Apr 21
- Adicionado o parâmetro
input_task_idaos endpoints Imagem para 3D e Multi-imagem para 3D. Faça referência diretamente à saída de uma tarefa concluída de Texto para imagem ou Imagem para imagem, 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 em resolução 4K (4096×4096) para maior detalhamento. Suportado apenas parameshy-6elatest. O padrão éfalse. - O pacote PBR retornado quando
enable_pbrétrueagora inclui um mapaemissionemtexture_urlspara tarefasmeshy-6elatestnos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D Refine e Retexturizar. Nenhuma alteração na requisição é necessária.
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 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: adicionado agrupamento de parâmetros com campos dependentes, valores padrão inline, selos de obrigatório/obsoleto, subnavegação expansível, e separadas as páginas de Multi-imagem, Rigging e Animação em páginas individuais.
Março de 2026
Apr 2
- Adicionado suporte ao formato
3mfao parâmetrotarget_formatsem todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: o 3MF é apenas opcional e deve ser solicitado explicitamente. - Nova API de Impressão Multicolorida: Converte modelos 3D para o formato 3MF multicolorido para impressão 3D. Suporta paletas de 1 a 16 cores com precisão configurável. 10 créditos por tarefa.
Mar 20
- Desativado o modelo de IA Meshy-4. Todas as requisições de API usando
meshy-4não são mais suportadas. Migre parameshy-6oulatest. - Adicionados os parâmetros
auto_sizeeorigin_ataos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D e Remesh. Quandoauto_sizeestá habilitado, o serviço usa visão de IA para estimar a altura real do objeto e redimensionar o modelo automaticamente.origin_atdefine a posição da origem (bottomoucenter). Na API de 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 formatos 3D devem ser gerados (por exemplo,["glb", "fbx"]) para reduzir o tempo de conclusão da tarefa.
February 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 resultados mais limpos sob iluminação personalizada. Suportado apenas parameshy-6elatest. O padrão étrue. - As APIs Retexturizar e Texto para 3D Refine agora suportam
meshy-6como valor deai_modelpara texturização completa com o 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 exatamente a aparência original. Suportado apenas parameshy-6elatest. O padrão étrue.
Feb 20
- Adicionado o parâmetro
model_typeà API Text to 3D Preview 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 lidar melhor com os erros da API.
Jan 26
- A API de Multi-imagem para 3D agora oferece suporte ao Meshy-6 para geração de malha completa. O parâmetro
ai_modelagora aceitameshy-6elatesté resolvido para o Meshy 6.
22 de janeiro
- Obsoleto o
art_stylepara a API Prévia de Texto para 3D (Meshy-6). O parâmetro foi projetado para modelos legados (Meshy-4 / Meshy-5) e será removido em uma versão futura. - Obsoleto o
enable_pbrpara as APIs Texto para 3D e Imagem para 3D quandoai_modelformeshy-4. Este parâmetro será removido em uma versão futura. - Atualizado o valor padrão do parâmetro
should_remeshpara o Meshy-6 nas APIs Texto para 3D e Imagem para 3D. O parâmetro agora tem como padrãofalseparameshy-6, etruepara outros modelos quando não especificado.
19 de janeiro
- A opção
latestparaai_modelnas APIs Texto para 3D (Prévia) e Imagem para 3D agora corresponde ao Meshy 6.
12 de janeiro
- Adicionado um novo parâmetro
model_typeà API Imagem para 3D para gerar malhas low-poly otimizadas com polígonos mais limpos.
Dezembro de 2025
31 de dezembro
- Lançado o API Playground, um espaço dedicado para desenvolvedores explorarem parâmetros de API e testarem requisições diretamente no site da Meshy.
- Introduzidas as APIs Texto para imagem e 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-bananaenano-banana-pro, com geração Multivista opcional.
Dec 22
- O campo
video_urlna 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 Text to 3D Preview, Imagem para 3D e Multi-imagem para 3D. Este parâmetro aceitaa-pose,t-poseou uma string vazia (padrão). O parâmetrois_a_t_poseagora está obsoleto em favor depose_mode.
November 2025
Nov 24
- As APIs Imagem para 3D e Multi-imagem para 3D adicionam um parâmetro opcional
save_pre_remeshed_modele expõemmodel_urls.pre_remeshed_glbquando um backup pré-remesh é solicitado.
Nov 06
- A API de Refine do Texto para 3D agora suporta
ai_model = latest, que resolve para Meshy 6 Preview. - A API de Imagem para 3D agora usa por padrã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 padrão, enquanto a geração de malha permanece no Meshy-5. - A API de Retexturizar adiciona uma opção
latestparaai_model(Meshy-6-preview) e agora a utiliza 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_uvestá ativada.
Outubro de 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 de Remesh para oferecer suporte à conversão do formato do arquivo de modelo de entrada apenas. - 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 de Texto para 3D para usar o Meshy 6 Preview. - Desconto temporário de 50% em vigor para tarefas de geração do 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 do Meshy-6-preview voltará ao valor normal de 20 créditos.
Sep 18
- Atualização dos 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
- Adicionado uma opção
latestparaai_modelna API Image to 3D para usar o Meshy 6 Preview.
Sep 4
- Expandido o suporte de entrada de
model_urlpara.glb,.gltf,.obj,.fbx,.stlpara 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 em pose A/T.
13 de ago
- O Meshy 5 agora é estável para Texto para 3D e Imagem para 3D (
ai_model:meshy-5), proporcionando melhor qualidade e consistência.
Julho de 2025
31 de jul
- Suporte a mapas de textura PBR na API através do parâmetro
enable_pbrpara o mais recente modelomeshy-5, nos endpoints Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar.
June 2025
Jun 25
- Adicionada a Retexture API, que permite aos usuários retexturizar modelos 3D com base nos mais recentes modelos de IA fundamentais da Meshy.
Jun 19
- Adicionadas 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
- 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 uma Data URI.
May 2025
May 20
- Adicionado um parâmetro opcional
moderationàs APIs Text to 3D Preview, Text to 3D Refine, Image to 3D e Multi-Image to 3D. Quando ativado, o conteúdo de entrada é automaticamente verificado quanto a possíveis conteúdos prejudiciais antes da geração.
15 de maio
- Introduzida a API de Auto-rigging e Animação, permitindo que os usuários façam rigging e animação automaticamente em modelos 3D. Saiba mais sobre Rigging e Animação.
Abril de 2025
29 de abr
- Introduzida a API de 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 de Texto para 3D e Imagem para 3D. A taglatestagora também aponta parameshy-5.
Apr 17
- Adicionado o parâmetro
texture_image_urlàs APIs de Imagem para 3D e Texto para 3D Refine, permitindo que os usuários guiem 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, possibilitando o acesso aos nossos futuros modelos avançados de IA para uma qualidade de geração aprimorada.
Mar 14
- A API de Texto para textura agora oferece suporte a modelos codificados em base64 no parâmetro
model_urlatravés de um Data URI, de forma semelhante aoimage_urlna API Imagem para 3D.
Mar 06
- Preços atualizados para tarefas de geração via 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 custa 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 que permite aos desenvolvedores testar a integração com a API sem consumir créditos. Todas as requisições válidas usando essa chave retornarão os mesmos resultados de tarefa de exemplo.
Feb 13
-
Alterações significativas:
- A criação de tarefas no nível gratuito terminará em
March 20, 2025. Depois disso, todas as requisições de tarefas da API exigirão uma assinatura paga. Para manter seu acesso sem interrupções, recomendamos que você faça o upgrade antes do prazo. - Use o código de cupom
APIACCESSpara aproveitar um desconto de40%. Obrigado por estar conosco!
- A criação de tarefas no nível gratuito terminará em
-
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 que os usuários guiem 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 configurações de simetria personalizáveis.
Dezembro de 2024
Dec 19
- Adicionadas as APIs de Remesh, que permitem aos usuários refazer o remesh e exportar modelos 3D existentes gerados por outras APIs da Meshy em diversos formatos.
- Atualizados os limites de contagem de polígonos de nossas APIs para uma faixa de 100 a 300.000 para usuários Premium.
Dec 12
- Obsoleto o parâmetro
model_urlem todos os objetos de resposta. - Separada a API legada do Meshy-3 da API mais recente do Meshy-4.
Dec 10
- Adicionado o parâmetro
enable_pbràs APIs de Imagem para 3D e Text to 3D Refine. - Adicionado o parâmetro
should_textureà API de Imagem para 3D. - Obsoleta a opção
pbrno parâmetroart_styleda API de Text to 3D Preview ao usar o modelo de IAmeshy-4. - Obsoleta a opção
low-polyno parâmetroart_styleda API de Text to 3D Preview.
Dec 5
- Adicionada uma Get Balance API para permitir que os usuários recuperem 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 agora usam o prefixo
/openapi. Os caminhos Legacy continuam sendo suportados, mas recomendamos migrar para os novos caminhos.
Novembro de 2024
Nov 14
- A Image to 3D API agora suporta imagens codificadas em base64.