Registro de alterações

Veja todos os recursos e atualizações mais recentes da Meshy API e dos plugins.

Setembro 2026

Sep 3

  • A etapa de protótipo da Creative Lab Lamp API agora retorna um modelo 3D: POST /prototype transforma a imagem do conceito em uma cúpula de luminária GLB oca, e o objeto da tarefa de protótipo ganha model_urls.glb e thumbnail_url além de image_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 placa de 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âmetro text do protótipo foi removido — image_url agora é obrigatório.

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 geometria de maior fidelidade com detalhes de superfície mais finos, por 5 créditos extras — o mesmo processamento Ultra que a API de Imagem para 3D oferece, agora disponível com entradas Multivista.
  • Removido meshy-t1 dos valores documentados de ai_model para o model_type Smart Topology da API de Imagem para 3D. O Smart Topology agora documenta apenas o meshy-t2; novas integrações devem usá-lo em vez disso. O Meshy T1 está planejado para descontinuação — se sua integração atualmente envia ai_model: "meshy-t1", migre para meshy-t2.

Agosto de 2026

Aug 28

  • Adicionamos a Usage API para times 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 por janela de tempo, endpoint e status, para controle 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 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 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 este 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 uniformes e planas 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 orientar 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 números diferentes de imagens.

Aug 17

13 de agosto

  • Adicionado ai_model: "meshy-7" à API 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 pré-visualização, 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 refinamento ou omita ai_model completamente.
  • Adicionado o model_type Smart Topology à API 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 (de 100 a 15.000, padrão 4.000). Uma pré-visualização com Smart Topology custa 5 créditos em vez de 20; consulte Preços. O model_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âmetro ultra_mode, que habilita a geração Ultra para um detalhamento de superfície ainda mais fino.
  • Adicionado ai_model: "meshy-7" à API de Multi-imagem para 3D: o modelo de geração multivista da Meshy, que se baseia em 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 detalhamento de superfície mais nítido 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.

Aug 4

  • Suporte de entrada model_url expandido para .glb, .gltf, .obj, .fbx, .stl nos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente .glb, .stl, .obj). O Reparar imprimibilidade 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 no estilo de blocos de montar. Mesmo fluxo de trabalho em duas etapas do Figure API — prototype (6 créditos) gera uma imagem de conceito estilizada, 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 22

  • Novo Creative Lab — Keycap API: transforma uma foto em uma keycap de teclado mecânico personalizada, em cores completas. Fluxo de trabalho em duas etapas — prototype (12 créditos) gera uma renderização do design da keycap finalizada, e então build (50 créditos) transforma o design escolhido (via candidate_id) em um modelo 3D de keycap com textura, com saídas em pacote GLB e OBJ, exportado em escala milimétrica real. 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 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. 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 continuam custando 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 Creative Lab — Vinyl Figure API: transforme uma foto em uma figura colecionável 3D de vinil com cabeça grande. Mesmo fluxo de trabalho de duas etapas da Figure API — prototype (6 créditos) gera uma imagem de conceito estilizada, 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 via 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 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 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.

June 2026

Jun 17

  • Nova página de documentação do API Playground: um console interativo para testar endpoints sem escrever código, e depois copiar o cURL, Python ou JavaScript equivalente. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.

15 de jun

  • Nova 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. Recebe um input_task_id (uma tarefa concluída de Imagem para 3D, Texto para 3D ou Remesh) ou um model_url (apenas .glb) e retorna um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas de até 40.000 faces (execute Remesh primeiro se for maior); malhas com quads e n-gons são trianguladas durante a geração do 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 do Prototype permanece inalterado em 6 créditos por imagem. Consulte Pricing 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 passa a renderizar 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 existente thumbnail_url permanece inalterado. O padrão é false.

Jun 1

  • Novas APIs do Creative Lab: uma família de endpoints específicos de produto que transformam uma foto de origem (ou prompt de texto) em um produto de consumo imprimível em 3D. Quatro produtos no lançamento — Keychain, Fridge Magnet, Figure e Lamp. Cada um segue um fluxo de trabalho de dois estágios prototype → build encadeado via input_task_id, servido sob URLs específicas 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 como true, a tarefa passa a renderizar também quatro miniaturas de vistas cardeais (frontal, direita, traseira, esquerda) e as retorna no novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Isso adiciona aproximadamente 3 segundos à latência da tarefa.

May 22

  • A funcionalidade de conversão e redimensionamento da API Remesh agora está disponível como endpoints independentes Convert API e Resize API. Os parâmetros obsoletos do 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 como true, a tarefa renderiza adicionalmente quatro miniaturas de vistas cardeais (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 de forma 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 concluída com sucesso da Meshy — ou qualquer URL de modelo 3D — quanto à prontidão para impressão 3D FDM. Padrão assíncrono de criação + streaming: o POST retorna um task_id, e então GET / stream SSE retornam métricas de estanqueidade, volume, buracos e arestas non-manifold assim que o status for SUCCEEDED. Gratuito, não consome créditos.
  • Nova API Reparar imprimibilidade: Repara um modelo 3D para imprimibilidade FDM — corrige arestas non-manifold, faces degeneradas, buracos 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 (via URL ou Data URI) em vez de um input_task_id de uma tarefa Meshy anterior. Formatos suportados: .glb, .fbx. Quando model_url e input_task_id são fornecidos simultaneamente, input_task_id tem prioridade.

Apr 21

  • Adicionado o parâmetro input_task_id aos endpoints Imagem para 3D e Multi-imagem para 3D. Referencie diretamente a 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 distintas.

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). Observação: o 3MF é opcional e deve ser solicitado explicitamente.
  • Nova API de Impressão Multicolorida: Converter 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 utilizam meshy-4 não são mais suportadas. Por favor, 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 utiliza visão computacional 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

Fevereiro de 2026

Feb 28

Feb 25

  • Adicionado o parâmetro image_enhancement às APIs de Imagem para 3D e Multi-imagem para 3D para usuários que desejam desativar a otimização da imagem de entrada e preservar a aparência exata de sua entrada. Suportado apenas para meshy-6 e latest. 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.

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 tratar melhor os erros da API.

Jan 26

  • A API de Multi-imagem para 3D agora suporta o Meshy-6 para geração de malha completa. O parâmetro ai_model agora aceita meshy-6 e latest é resolvido para o Meshy 6.

Jan 22

  • Obsoleto art_style para a API de Preview de Texto para 3D (Meshy-6). O parâmetro foi projetado para modelos Legacy (Meshy-4 / Meshy-5) e será removido em uma versão futura.
  • Obsoleto enable_pbr para as APIs de 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 de Texto para 3D e Imagem para 3D. O parâmetro agora tem como padrão false para meshy-6, e true para os demais modelos, caso não seja especificado.

Jan 19

Jan 12

  • 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

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 API de Texto para imagem e a API de Imagem para imagem, 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-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

Novembro 2025

Nov 24

  • As APIs de 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 Refinamento de Texto para 3D agora suporta ai_model = latest, que se 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 Meshy-6-preview para texturização por padrão enquanto a geração de malha permanece 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 as texturas para modelos enviados.
  • A API de Retexturizar agora preserva as texturas para modelos enviados quando a opção enable_original_uv está habilitada.

October 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 apenas do 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 de 2025

Sep 23

  • Adicionada uma opção latest para ai_model na 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 o custo 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

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

Sep 4

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

August 2025

Aug 18

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

Junho de 2025

Jun 25

  • Adicionada a API de Retexturizar, que permite aos usuários retexturizar modelos 3D com base nos mais recentes modelos de IA de fundação da Meshy.

Jun 19

Jun 17

  • Adicionada documentação para Webhooks.

10 de jun

  • A Remesh API agora suporta modelos GLB codificados em base64 no parâmetro model_url via Data URI.

Maio de 2025

20 de mai

15 de maio

  • Introduzida a API de Auto-rigging & Animação, permitindo aos usuários realizar automaticamente o rigging e a animação de 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 do 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 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 Texto para 3D e Imagem para 3D, permitindo acesso aos nossos próximos modelos avançados de IA para melhor qualidade de geração.

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 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 solicitaçõ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. Após isso, todas as solicitações de tarefas via API exigirão uma assinatura paga. Para manter seu acesso sem interrupções, recomendamos que você faça o upgrade antes do prazo final.
    • Use o código de cupom APIACCESS para aproveitar um desconto de 40%. Obrigado por estar conosco!

  • Adicionados endpoints de streaming via 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 Text to 3D Refine, permitindo que os usuários guiem o processo de geração de textura com um prompt de texto.

Janeiro 2025

Jan 23

14 de Janeiro

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

07 de Janeiro

Dezembro de 2024

19 de Dezembro

  • Adicionadas as APIs de Remesh, 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

  • Obsoleto: propriedade model_url em todos os objetos de resposta.
  • Separada a API legada Meshy-3 da API mais recente 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.

November 2024

Nov 14