lowpoly será descontinuado em 30 de out. de 2026. meshy-7 como modelo de geração 3D será descontinuado em 31 de dez. de 2026; como modelo de textura continua disponível. Troque de modelo antes dessas datas para evitar erros nas solicitações. Ver todas as descontinuações

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 quadruped a um rig de quadrúpede, com action_id ou action_ids. Qualquer animação quadruped funciona 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_type em cada animação, biped ou quadruped. Um rig aceita apenas animações do seu próprio tipo.

Nov 16

  • Adicionados color_mapping e target_formats à API de Relevo. color_mapping: true colore os arquivos GLB, OBJ, FBX e USDZ com a foto, e target_formats adiciona 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 com meshy 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_template ao Rigging. Ele entrega um personagem bípede no esqueleto esperado pelo seu engine ou ferramenta, como mixamo ou ue5_mannequin. As tarefas de Animação usam o esqueleto do rig. O v1 do Rigging usa meshyrig por padrão, como antes, e o v2 do Rigging usa mixamo por padrão.
  • Adicionado include_fingers ao Rigging. Defina como true para adicionar ossos dos dedos às mãos de um personagem bípede, em qualquer esqueleto.
  • meshy-7 será desativado em 31 de dezembro de 2026 como o ai_model das tarefas de preview de Texto para 3D, Imagem para 3D e Multi-imagem para 3D. A partir dessa data, requisições que enviarem ai_model: "meshy-7" para esses endpoints retornarão 400. Mude para meshy-7.1, que aceita os mesmos parâmetros e custa o mesmo. O meshy-7 como modelo de textura continua disponível. Isso abrange Retexturizar, texture_model e o ai_model de um refine de Texto para 3D. Veja Descontinuações.

Nov 6

  • Adicionados gpt-image-2-6-flare e gpt-image-2-6-sunburst aos valores de ai_model das 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 que gpt-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: false retorna apenas o mapa de profundidade. 20 créditos por tarefa.

3 de novembro

  • Adicionado texture_model a 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 qualquer ai_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 seu ai_model mais o preço do Retexturizar na sua resolução de textura; veja Preços. Solicitações sem texture_model funcionam como antes.
  • Adicionado ai_model: "meshy-n1" ao refine de Texto para 3D. Sem texture_image_url, o Meshy N1 aplica texturas a partir da imagem de referência que um preview do Meshy 7.1 ou latest armazena. Outros previews precisam de texture_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. latest ainda corresponde ao Meshy 7.

Outubro de 2026

Oct 30

  • Algumas requisições do Meshy T1 (model_type: "lowpoly" ou ai_model: "meshy-t1") em Texto para 3D e Imagem para 3D agora rodam no Smart Topology, e as demais retornam 400. model_type: "smart-topology" com ai_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. Com keep_texture: true, cada parte de um modelo texturizado mantém a textura, e a tarefa retorna os mapas de textura em texture_urls, além de um arquivo mtl com 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_id també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_url tornado obsoleto em Rigging. O Meshy usa as texturas incorporadas no arquivo model_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-Metadata para 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, como user=alex@example.com,team=fab, e leia-os de volta no campo metadata dos registros de Usage. Veja Metadata.

Oct 19

  • export_resolution agora aceita valores de até 512, reduzido de 2048, 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. 512 também é o valor padrão, então chamadas que nunca definem export_resolution não são afetadas. Um valor acima de 512 agora retorna 400 no momento da criação, em vez de ser aceito. 2048 em particular sempre ultrapassava o prazo do gerador e falhava depois que a tarefa já havia iniciado. Se você definir export_resolution acima de 512, remova o parâmetro ou defina-o como 512.

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 com model_type: "smart-topology"; a saída é somente triângulos, e target_polycount aceita de 100 a 30.000 (padrão 15.000). O preço é o mesmo de meshy-t2; veja Preços. Ele agora é o padrão quando model_type: "smart-topology" é definido sem ai_model; defina ai_model: "meshy-t2" para continuar usando o Meshy T2. O Multi-imagem para 3D não oferece suporte a meshy-t2.5.

14 de out

  • model_url agora aceita arquivos de até 400 MB, acima dos 100 MB anteriores, quando é uma URL http ou https, em Retexturizar, Remesh, Rigging, Converter, Redimensionar, Desdobramento UV, Multi-Color Print, Analisar imprimibilidade e Reparar imprimibilidade. Um URI data: 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 retorna 400. 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 404 e o mesmo corpo de um id inexistente quando um input_task_id pertence a outra conta, em vez de 403. 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 usdz em model_urls das tarefas de Texto para 3D, Imagem para 3D, Multi-imagem para 3D, Retexturizar, Remesh, Converter, Redimensionar e Auto Split agora declara metersPerUnit = 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-5 foi descontinuado. Requisições que enviam ai_model: "meshy-5" para Text to 3D, Image to 3D, Multi-Image to 3D ou Retexture agora retornam 400 com a mensagem ai_model meshy-5 has been retired; use meshy-6-lite. Mude para meshy-6-lite, que aceita os mesmos parâmetros pelo mesmo custo em créditos. Modelos que você já gerou com meshy-5 continuam disponíveis, e fazer o refine de uma preview do meshy-5 sem definir ai_model continua funcionando.
  • .webp agora está documentado como um formato de imagem de entrada suportado, junto com .jpg, .jpeg e .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_credits e monthly_resets_at, para que você possa ver quanto do seu saldo expira na próxima renovação. O balance em 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 em printability.thin_walls, e Reparar imprimibilidade as espessa quando necessário, podendo reutilizar a impressora e o tamanho de uma tarefa de análise passada como input_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çalho Deprecation e um cabeçalho Link apontando para o novo caminho.

Sep 28

  • As respostas da API agora incluem cabeçalhos de limite de taxa, incluindo Retry-After para indicar quanto tempo esperar antes de tentar novamente ou fazer nova consulta.
  • Multi-Color Print agora aceita um novo parâmetro printer_brand que 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 documenta max_depth.

18 de setembro

  • Adicionado meshy-7.1 como valor de ai_model para Imagem para 3D, Multi-imagem para 3D e Texto para 3D: mesmos parâmetros e custo em créditos de meshy-7, com maior detalhamento de geometria. latest agora é resolvido para meshy-7.1; meshy-7 está obsoleto, mas continua funcionando sem alterações.
  • Adicionado geometry_resolution (standard / 2k / 4k) às mesmas APIs, substituindo o agora obsoleto ultra_mode (ultra_mode: true ainda funciona e equivale a "2k"). 4k requer Meshy 7.1 (meshy-7.1 ou latest), não está disponível em Multi-imagem para 3D, e custa os mesmos 5 créditos extras que 2k.

16 de setembro

  • A API do Auto Split agora aceita um input_task_id texturizado. Anteriormente, ela rejeitava um com 400, o que significava gerar a mesma malha uma segunda vez com should_texture: false para 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-5 será descontinuado em 10 de outubro de 2026. Ele não está mais documentado como um valor de ai_model para Texto para 3D, Imagem para 3D, Multi-imagem para 3D ou Retexturizar, e após 10 de outubro, solicitações que enviarem ai_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-flare e gpt-image-2-5-sunburst aos valores documentados de ai_model para 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 do gpt-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ções 4:3 e 3:4 nas APIs de Texto para imagem e Imagem para imagem, além de 1:1, 16:9, 9:16, 3:2 e 2: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 para reference_image_urls.

Sep 11

  • Mudança de comportamento: DELETE em uma tarefa que já está IN_PROGRESS agora é rejeitado com 409 Conflict, e a tarefa continua em execução. Anteriormente, isso retornava 200 OK, interrompia o worker e descartava o resultado, mas mantinha os créditos, pois apenas tarefas PENDING sã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, FAILED ou CANCELED e então a exclua. Tarefas PENDING ainda 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-lite aos valores documentados de ai_model para as APIs de Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar. Ele é o sucessor do meshy-5: mesmos parâmetros, mesmo custo em créditos (5 para a malha, 15 com textura, 10 para uma retexturização).
  • meshy-5 agora 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 envia ai_model: "meshy-5", migre para meshy-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 em glb, obj, fbx, usdz, blend ou 3mf, seja montado ou disposto na plataforma de impressão (layout). 10 créditos por tarefa.

Sep 7

  • Adicionado o parâmetro name_text ao 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 retorna name_text para que você possa confirmar o texto exato antes da construção. name continua 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. Informe type como person ou other para escolher o estilo de pixelização. POST /build (30 créditos) amostra a imagem em uma grade 16 ou 32 e transforma cada pixel em uma peça square ou hex encaixá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 com piece_size_mm, color_count e piece_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 POST leva 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 /prototype transforma a imagem conceitual em um GLB de abajur oco, e o objeto de tarefa de protótipo ganha model_urls.glb e thumbnail_url ao lado de image_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âmetro text do protótipo foi removido, e image_url agora é 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, e post_process se 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 no ai_model meshy-7 (ou latest) 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-t1 dos valores de ai_model documentados para o model_type Smart Topology da API de Imagem para 3D. O Smart Topology agora documenta apenas meshy-t2; novas integrações devem usá-lo em seu lugar. O Meshy T1 está planejado para ser descontinuado. Se sua integração atualmente envia ai_model: "meshy-t1", migre para meshy-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 um action_id predefinido. Mesmo custo de 3 créditos por tarefa.

Aug 24

  • Suporte expandido para aspect_ratio no gpt-image-2 nas APIs de Texto para imagem e Imagem para imagem para adicionar 16:9 e 9:16. O gpt-image-2 agora aceita 1:1, 16:9, 9:16, 3:2 e 2:3; 4:3 e 3:4 permanecem 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 mode swift (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: escolha realistic (padrão) para cores fiéis à textura, ou cartoon para regiões de cor plana e uniforme e um 3MF menor.
  • Adicionado o parâmetro remove_background a todos os endpoints de protótipo do Creative Lab: Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet e Lamp. Defina remove_background: true para 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 único texture_image_url. Requer ai_model meshy-7 ou latest, e é independente de image_urls. As duas listas podem conter imagens diferentes e quantidades diferentes de imagens.

Aug 17

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âmetro ultra_mode na 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, passe ai_model: "meshy-7" na tarefa de refine ou omita ai_model completamente.
  • Adicionado o model_type Smart Topology à API de Texto para 3D. Defina model_type: "smart-topology" para gerar com meshy-t2: topology mais limpa, partes nativamente separadas, saída em triângulos e uma contagem de faces que você pode definir com target_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. O model_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âmetro ultra_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âmetro multiview_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_url para .glb, .gltf, .obj, .fbx, .stl nos 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, e 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 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ão build (50 créditos) transforma o design escolhido (com candidate_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. Em 8k, 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/4k permanecem em 10). Consulte Preços.
  • O booleano hd_texture está obsoleto em favor de texture_resolution. Ele ainda é respeitado e equivale a texture_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, e build (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_type Smart Topology à API Imagem para 3D, oferecendo dois modelos por meio de ai_model: meshy-t1 (o modelo low-poly atual) e meshy-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 com target_polycount). meshy-t2 é o padrão em smart-topology. O model_type: lowpoly existente 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ão 1:1, 16:9, 9:16, 4:3, 3:4 para os modelos nano-banana e 1:1, 3:2, 2:3 para gpt-image-2. Opcional; o padrão é 1:1 e não pode ser combinado com generate_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 uma model_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 como true, a tarefa renderiza adicionalmente uma versão com fundo transparente (RGBA) da pré-visualização e a retorna no novo campo de resposta alpha_thumbnail_url. O campo thumbnail_url existente 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 de input_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 como true, a tarefa renderiza adicionalmente quatro thumbnails de vistas cardeais (frente, direita, trás, esquerda) e os retorna no novo campo de resposta thumbnail_urls. O campo thumbnail_url existente 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 como true, a tarefa renderiza adicionalmente quatro miniaturas de visualização cardinal (frontal, direita, traseira, esquerda) e as retorna no novo campo de resposta thumbnail_urls. O campo thumbnail_url existente 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 com resize_height e auto_size.

11 de maio

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_id existente da Meshy ou um model_url (.glb, .stl, .obj). O formato de saída corresponde ao de entrada. 10 créditos por tarefa.

Abril de 2026

Apr 27

  • Adicionado o campo consumed_credits a todas as respostas de tarefas em todos os endpoints da API. Mostra o número de créditos consumidos por cada tarefa. O campo está presente para tarefas nos status PENDING, IN_PROGRESS e SUCCEEDED. Retorna 0 para tarefas FAILED (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_url ao endpoint Multi-Color Print. Envie um modelo 3D texturizado diretamente (com uma URL ou Data URI) em vez de um input_task_id de uma tarefa anterior do Meshy. Formatos suportados: .glb, .fbx. Quando tanto model_url quanto input_task_id são fornecidos, input_task_id tem prioridade.

Apr 21

  • Adicionado o parâmetro input_task_id aos 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 fornecer image_url / image_urls. Quando ambos são fornecidos, input_task_id tem prioridade.

Apr 20

Apr 14

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 3mf ao parâmetro target_formats em 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-4 não são mais suportadas. Migre para meshy-6 ou latest.
  • Adicionados os parâmetros auto_size e origin_at aos endpoints Imagem para 3D, Multi-imagem para 3D, Texto para 3D e Remesh. Quando auto_size está habilitado, o serviço usa visão de IA para estimar a altura real do objeto e redimensionar o modelo automaticamente. origin_at define a posição da origem (bottom ou center). Na API de Remesh, auto_size é mutuamente exclusivo com resize_height.

Mar 17


February 2026

Feb 28

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 para meshy-6 e latest. 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_model agora aceita meshy-6 e latest é resolvido para o Meshy 6.

22 de janeiro

  • Obsoleto o art_style para 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_pbr para as APIs Texto para 3D e Imagem para 3D quando ai_model for meshy-4. Este parâmetro será removido em uma versão futura.
  • Atualizado o valor padrão do parâmetro should_remesh para o Meshy-6 nas APIs Texto para 3D e Imagem para 3D. O parâmetro agora tem como padrão false para meshy-6, e true para outros modelos quando não especificado.

19 de janeiro

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-banana e nano-banana-pro, com geração Multivista opcional.

Dec 22

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

Dec 04


November 2025

Nov 24

  • As APIs Imagem para 3D e Multi-imagem para 3D adicionam um parâmetro opcional save_pre_remeshed_model e expõem model_urls.pre_remeshed_glb quando 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 = latest e should_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 latest para ai_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_uv está ativada.

Outubro de 2025

Oct 28

  • Adicionado o cabeçalho de resposta x-api-version para indicar a versão atual do servidor da API.

Oct 20

  • Adicionado um parâmetro booleano opcional convert_format_only à API 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 latest para ai_model na 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

Sep 16

  • Adicionado uma opção latest para ai_model na API Image to 3D para usar o Meshy 6 Preview.

Sep 4

  • Expandido o suporte de entrada de model_url para .glb, .gltf, .obj, .fbx, .stl para Remesh e Retexture.

Agosto de 2025

Aug 18

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


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

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_url através de uma Data URI.

May 2025

May 20

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 tag latest agora também aponta para meshy-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

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 APIACCESS para aproveitar um desconto de 40%. Obrigado por estar conosco!
  • 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

Jan 14

  • Obsoleto as APIs legadas de Texto para 3D e Imagem para 3D baseadas nos modelos de IA Meshy-3.

Jan 07


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_url em todos os objetos de resposta.
  • Separada a API legada do Meshy-3 da API mais recente do Meshy-4.

Dec 10

Dec 5

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