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 Developer Platform.
Setembro 2026
Sep 18
- Adicionado
meshy-7.1como um valor deai_modelpara Image to 3D, Multi-Image to 3D e Text to 3D: mesmos parâmetros e custo em créditos que omeshy-7, maior detalhe de geometria.latestagora resolve 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 set
- 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: falseapenas para dividi-la. Observe o que uma divisão retorna: ela recorta 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 sólida por parte — isso já era verdade para toda divisão e permanece inalterado. meshy-5foi descontinuado. Ele não está mais disponível como valor deai_modelpara Texto para 3D, Imagem para 3D, Multi-imagem para 3D ou Retexturizar. Se sua integração enviarai_model: "meshy-5", mude parameshy-6-lite— ele aceita os mesmos parâmetros e custa o mesmo.
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 OpenAI GPT Image 2.5, com preço igual aogpt-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— encadeie diretamente a partir de uma tarefa de Texto para imagem ou Imagem para imagem concluída, em vez de copiar suas URLs de saída 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 — mantendo os créditos, pois apenas tarefasPENDINGsão reembolsáveis, então 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,FAILEDouCANCELED, e então exclua-a. TarefasPENDINGainda são excluídas e reembolsadas exatamente como antes, e tarefas em estado terminal ainda são excluídas. Aplica-se a todas as famílias de tarefas em/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. É o sucessor domeshy-5: mesmos parâmetros, mesmo custo em créditos (5 para a malha, 15 com textura, 10 para uma retexturização). - O
meshy-5agora está obsoleto em todas as APIs que o aceitam. Ele continua funcionando e nada muda em relação à sua solicitação ou à sua fatura, 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: divida um modelo Meshy 6 ou Meshy 7 sem textura em partes imprimíveis separadamente — automaticamente, pelas partes que você nomear (
by_parts), ou por região de cor (by_color) — com conectores tipo espiga e encaixe opcionais e reforço de parede fina. Exporta cada parte como um objeto próprio emglb,obj,fbx,usdz,blendou3mf, seja montado ou organizado 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 com 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. Observe quenamecontinua 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 um fidget board de pixel art multicolorido e imprimível em 3D em duas etapas.
POST /prototype(6 créditos) pixeliza a foto em uma imagem de pixel art — passetypecomopersonouotherpara escolher o estilo de pixelização — ePOST /build(30 créditos) faz a amostragem em uma grade16ou32e transforma cada pixel em uma peçasquareouhexencaixável, entregue como um único 3MF com marcação de cores para impressão multifilamento. A geometria da peça é ajustável viapiece_size_mm,color_countepiece_height_mm.
Sep 4
- Adicionado
GET /openapi/v1/animations/libraryà Biblioteca de animações: obtenha todas as ações predefinidas que a Animation API aceita —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 brinquedo fidget colapsável pronto para impressão, no qual 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á um par de estágios prototype/build nem parâmetros de geometria para ajustar. Cada tarefa custa 6 créditos e retorna tanto um STL para impressão quanto um GLB para pré-visualização.
Sep 3
- O protótipo da Creative Lab Lamp API agora retorna um modelo 3D:
POST /prototypetransforma a imagem do conceito em um GLB de cúpula de luminária oca, e o objeto de tarefa do protótipo ganhamodel_urls.glbethumbnail_urlalém deimage_urls. A etapa de build executa apenas o processador de luminária nesse modelo e agora produz uma cúpula de luminária com fundo aberto e uma base para o encaixe da fonte de luz. Os preços mudam de acordo com 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 —image_urlagora é obrigatório.
Sep 2
- A Animation API agora aceita
action_ids— aplique até 10 ações predefinidas a um personagem com rig em uma única requisição e receba um único arquivo contendo um clipe de animação por ação, pronto para ser acionado a partir de uma máquina de estados em um motor de jogo. Os clipes mantêm a ordem em que você os lista e carregam o nome da biblioteca da animação. Custa 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à Multi-imagem para 3D API: habilita a geração Ultra noai_modelmeshy-7(oulatest) para geometria de maior fidelidade com detalhes de superfície mais finos, por 5 créditos extras — a mesma etapa Ultra que a Imagem para 3D API oferece, agora disponível com entradas Multivista. - Removido
meshy-t1dos valores deai_modeldocumentados para omodel_typeSmart Topology da Imagem para 3D API. O Smart Topology agora documenta apenasmeshy-t2; novas integrações devem usá-lo em vez disso. O Meshy T1 está planejado para descontinuação — 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— aplique 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
- Ampliado o suporte a
aspect_ratiopara ogpt-image-2nas APIs Texto para imagem e Imagem para imagem para incluir16:9e9:16. Ogpt-image-2agora aceita1:1,16:9,9:16,3:2e2:3;4:3e3:4continuam sem suporte para este modelo.
Aug 21
- Adicionada a Text to Motion API: gere um clipe de movimento de personagem a partir de uma descrição em linguagem natural, sem necessidade de um 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(padrão) para cores fiéis à textura, oucartoonpara regiões de cor uniformes e planas e um 3MF menor. - Adicionado o parâmetro
remove_backgrounda todos os endpoints de prototipagem do Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet e Lamp. Definaremove_background: truepara receber a imagem do prototype 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.
Aug 13
- Adicionado
ai_model: "meshy-7"à API de Texto para 3D: nosso mais novo modelo de geração 3D, com geometria de fidelidade superior à do 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 do 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 para compatibilidade retroativa.
Aug 12
- Adicionado
ai_model: "meshy-7"à API de Imagem 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_mode, que ativa a geração Ultra para um detalhamento de superfície ainda mais refinado. - Adicionado
ai_model: "meshy-7"à API de Multi-imagem para 3D: o modelo de geração Multivista da Meshy, que se baseia em todas as suas visualizações 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 detalhamento de superfície mais nítido 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 visualizações ordenadas do mesmo objeto para conduzir a texturização multivista.
Aug 4
- Expandido o suporte de entrada de
model_urlpara.glb,.gltf,.obj,.fbx,.stlnos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente.glb,.stl,.obj). O reparo retorna o asset reparado em seu formato de entrada.
July 2026
Jul 27
- Novo Creative Lab — Brick Figure API: transforme uma foto em uma minifigura 3D colecionável estilo brick. Mesmo fluxo de trabalho em duas etapas do Figure API —
prototype(6 créditos) gera uma imagem de conceito estilizada,build(30 créditos) transforma isso em um modelo 3D texturizado com saídas em GLB e OBJ + MTL. Veja Preços para o detalhamento completo.
Jul 22
- Novo Creative Lab — Keycap API: transforma uma foto em uma keycap personalizada de teclado mecânico, em cores completas. Fluxo de trabalho em dois estágios —
prototype(12 créditos) gera uma renderização de design da keycap finalizada, depoisbuild(50 créditos) transforma o design escolhido (viacandidate_id) em um modelo 3D texturizado de keycap, 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. Veja Preços para o detalhamento completo.
Jul 21
- Agora oferecemos suporte a texturas base color de 8K por meio 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. No modo8k, 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 Pricing. - O booleano
hd_textureestá obsoleto em favor detexture_resolution— ele ainda é respeitado e é equivalente atexture_resolution: "4k"para compatibilidade com versões anteriores.
Jul 20
- Novo Creative Lab — Vinyl Figure API: transforme uma foto em uma figura 3D colecionável de vinil com cabeça grande. Mesmo fluxo de trabalho em dois estágios do Figure API —
prototype(6 créditos) gera uma imagem conceitual estilizada,build(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 13
- Adicionado um novo
model_typeSmart Topology à API Imagem para 3D, oferecendo dois modelos viaai_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 ao 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 durante a edição. 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:1, e não pode ser combinado comgenerate_multi_view.
June 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 equivalente em cURL, Python ou JavaScript. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.
Jun 15
- Nova UV Unwrap API: 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 de Image to 3D, Text to 3D ou Remesh já concluída) ou umamodel_url(apenas.glb) e retorna um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas com até 40.000 faces (execute o Remesh primeiro se for maior); malhas com quads e n-gons são trianguladas durante a geração de 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). Lamp permanece inalterado em 30 créditos. O preço de 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 passa a renderizar também uma versão com fundo transparente (RGBA) da pré-visualização e a retorna no novo campo de respostaalpha_thumbnail_url. Othumbnail_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 — Keychain, Fridge Magnet, Figure e Lamp. Cada um segue um fluxo de trabalho de duas etapas,
prototype→build, encadeadas viainput_task_id, disponibilizadas sob URLs com escopo de produto (/openapi/creative-lab/<product>/v1/...) com versionamento por produto, para que os produtos possam 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 passa a renderizar também quatro thumbnails de vistas cardeais (frontal, direita, traseira, esquerda) e as retorna no novo campo de respostathumbnail_urls. O campothumbnail_urlexistente permanece inalterado. Isso 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 independentes Convert API e Resize API. Os parâmetros obsoletos na Remesh continuarão funcionando para manter a compatibilidade retroativa.
13 de maio
- Adicionado o parâmetro
multi_view_thumbnailsà API Imagem para 3D. Quando definido comotrue, a tarefa renderiza adicionalmente quatro thumbnails de visualização cardeal (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 de forma que a maior dimensão da caixa delimitadora seja igual ao valor especificado em metros. Mutuamente exclusivo comresize_heighteauto_size.
May 11
- Parâmetro
symmetry_modeobsoleto nos endpoints Texto para 3D, Imagem para 3D e Multi-imagem para 3D. Este parâmetro não afeta mais o resultado.
May 7
- Nova API Analisar imprimibilidade: Analise uma tarefa Meshy bem-sucedida — ou qualquer URL de modelo 3D — quanto à prontidão para impressão 3D FDM. Padrão assíncrono de criação + stream: o POST retorna um task_id, e então o GET / stream SSE retornam métricas de estanqueidade, volume, buracos e arestas non-manifold assim que SUCCEEDED. Gratuito, sem consumo de créditos.
- Nova API Reparar imprimibilidade: Repare um modelo 3D para imprimibilidade FDM — corrija arestas non-manifold, faces degeneradas, buracos e outros problemas de topology. Aceita um
input_task_idde uma tarefa Meshy existente 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 com textura diretamente (via 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 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, Text to 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, Text to 3D Refine e Retexturizar. Nenhuma alteração na requisição é necessária.
14 de abril
- 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 da decimação adaptativa:1(ultra),2(alto),3(médio) ou4(baixo).
12 de abril
- Reestruturada a documentação da API: adicionado agrupamento de parâmetros com campos dependentes, valores padrão inline, indicadores 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
3mfno parâmetrotarget_formatsem todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Observação: o 3MF é opcional e deve ser solicitado explicitamente. - Nova API de Impressão Multicolorida: Converta 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
- Descontinuado o modelo de IA Meshy-4. Todas as requisições de API que usam
meshy-4não são mais suportadas. Por favor, 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 no mundo real 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 obter 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 de Imagem para 3D e Multi-imagem para 3D para usuários que desejam optar por não usar a otimização da imagem de entrada e preservar a aparência exata de sua entrada. Suportado apenas parameshy-6elatest. O padrão é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.
January 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 desenvolvedores a entender 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-6elatesté resolvido para o Meshy 6.
22 de Janeiro
- Marcado como obsoleto o
art_stylepara a API de Preview 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. - Marcado como obsoleto o
enable_pbrpara as APIs de 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 de Texto para 3D e Imagem para 3D. O parâmetro agora assumefalsepor padrão parameshy-6, etruepara os demais modelos, caso não seja especificado.
Jan 19
- A opção
latestparaai_modelnas APIs Text to 3D (Preview) e Image to 3D agora aponta para o Meshy 6.
Jan 12
- Adicionado um novo parâmetro
model_typeà API Image to 3D para gerar malhas low-poly otimizadas para polígonos mais limpos.
December 2025
Dec 31
- Lançamos o API Playground, um espaço dedicado para desenvolvedores explorarem parâmetros de API e testarem requisições diretamente no site da Meshy.
- Apresentamos a Text to Image API e a Image to Image API, permitindo geração de imagens com IA a partir de prompts de texto e edição de imagens a partir de imagens de referência. Ambas as APIs 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. Esse 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 de Texto para 3D agora suporta
ai_model = latest, que é resolvido 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 usa essa opção por padrão quando omitida.
Nov 04
- A API de Remesh agora preserva as texturas de modelos enviados.
- A API de Retexturizar agora preserva as texturas de modelos enviados quando a opção
enable_original_uvestá habilitada.
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 permitir converter apenas o formato do arquivo do modelo de entrada. - Adicionado
rigged_character_glb_urlà resposta do Objeto de Tarefa de Rigging.
Oct 01
- Remoção das APIs
text-to-voxel
Setembro 2025
Sep 23
- Adicionada uma opção
latestparaai_modelna API 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 retornará 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
- Adicionada uma opção
latestparaai_modelna API Image to 3D para usar o Meshy 6 Preview.
Sep 4
- Ampliado o suporte de entrada de
model_urlpara.glb,.gltf,.obj,.fbx,.stlnas APIs 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), oferecendo qualidade e consistência aprimoradas.
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-5nos endpoints Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar.
June 2025
Jun 25
- Adicionada a API de Retexturizar, 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 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 API de Remesh agora oferece suporte a modelos GLB codificados em base64 no parâmetro
model_urlvia Data URI.
Maio de 2025
May 20
- Adicionado um parâmetro opcional
moderationàs APIs de Texto para 3D Preview, Texto para 3D Refine, Imagem para 3D e Multi-imagem para 3D. Quando ativado, o conteúdo de entrada é automaticamente verificado em busca de conteúdo potencialmente prejudicial antes da geração.
15 de maio
- Introduzida a API de Auto-rigging & Animação, permitindo que os usuários façam rigging e animem modelos 3D automaticamente. Saiba mais sobre Rigging e Animação.
Abril de 2025
29 de abril
- 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 do modelo de IA
meshy-5às APIs de Texto para 3D e Imagem para 3D. A taglatestagora também resolve parameshy-5.
Apr 17
- Adicionado o parâmetro
texture_image_urlàs APIs Imagem para 3D e Texto para 3D Refine, permitindo que os usuários guiem 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, possibilitando o acesso aos nossos futuros modelos avançados de IA para melhorar a qualidade da geração.
Mar 14
- A API de Texto para textura agora suporta modelos codificados em base64 no parâmetro
model_urlvia 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
February 2025
Feb 18
- Adicionada uma chave de API do modo de teste que permite que desenvolvedores testem a integração da 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 drásticas:
- A criação de tarefas no nível gratuito terminará em
March 20, 2025. Após essa data, todas as requisições de tarefas da API exigirão uma assinatura paga. Para manter seu acesso sem interrupções, recomendamos fazer o upgrade antes do prazo final. - 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.
Janeiro de 2025
Jan 23
- Adicionados endpoints para listar tarefas às APIs Texto para 3D, Imagem para 3D, Remesh e Texto para textura.
Jan 14
- Descontinuadas 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.
December 2024
Dec 19
- Adicionadas as Remesh APIs, que permitem aos usuários fazer remesh e exportar modelos 3D existentes gerados por outras APIs da Meshy em vários formatos.
- Atualizados os limites de contagem de polígonos de nossas APIs para uma faixa de 100-300.000 para usuários Premium.
Dec 12
- Obsoletou o parâmetro
model_urlem todos os objetos de resposta. - Separou a API Meshy-3 legada da API Meshy-4 mais recente.
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. - Obsoletou a opção
pbrno parâmetroart_styleda API Text to 3D Preview ao usar o modelo de IAmeshy-4. - Obsoletou a opção
low-polyno parâmetroart_styleda API Text to 3D Preview.
Dec 5
- Adicionada uma Get Balance API para permitir que os usuários recuperem o 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.
November 2024
Nov 14
- A Image to 3D API agora suporta imagens codificadas em base64.