Registro de alterações

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

Agosto 2026

12 de Agosto

  • Adicionado ai_model: "meshy-7" à Image to 3D API: nosso mais novo modelo de geração 3D, com geometria de maior fidelidade que o Meshy 6. Também introduz o parâmetro ultra_mode, que habilita a geração Ultra para detalhes de superfície ainda mais finos.
  • Adicionado ai_model: "meshy-7" à Retexture API: nosso mais novo modelo de texturização, com detalhes de superfície mais nítidos e materiais PBR mais limpos que o Meshy 6. Também introduz o parâmetro multiview_image_urls — forneça 1–4 vistas ordenadas do mesmo objeto para impulsionar a texturização multivista.
  • Adicionado ai_model: "meshy-7" à Multi-Image to 3D API: modelo de geração multivista da Meshy, que condiciona todas as entradas de visualizações e impulsiona a texturização a partir delas.

4 de Agosto

  • Suporte expandido de entrada model_url para .glb, .gltf, .obj, .fbx, .stl para os endpoints Analyze Printability e Repair Printability (anteriormente .glb, .stl, .obj). O Repair retorna o asset reparado no formato de entrada.

Julho 2026

27 de Julho

  • Nova Creative Lab — Brick Figure API: transforme uma foto em um minifigurinha colecionável em estilo de tijolos. Mesmo fluxo de trabalho em 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 GLB e OBJ + MTL. Consulte Preços para o detalhamento completo.

22 de Julho

  • Nova Creative Lab — Keycap API: transforme uma foto em um keycap personalizado de teclado mecânico em cores completas. Fluxo de trabalho em duas etapas — prototype (12 créditos) gera um design de keycap finalizado, então build (50 créditos) transforma o design escolhido (via candidate_id) em um modelo 3D texturizado de keycap com saídas nos formatos 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.

21 de Julho

  • Agora suportamos texturas de cor base 8K via 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 8K custa 15 créditos (2k/4k continuam 10). Veja Preços.
  • O booleano hd_texture está obsoleto em favor de texture_resolution — ainda é honrado e equivalente a texture_resolution: "4k" para compatibilidade retroativa.

20 de Julho

  • Nova Creative Lab — Vinyl Figure API: transforme uma foto em uma grande cabeça de vinil colecionável em figura 3D. Mesmo fluxo de trabalho em 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 GLB e OBJ + MTL. Veja Preços para o detalhamento completo.

13 de Julho

  • Adicionado um novo Smart Topology model_type à Image to 3D API, oferecendo dois modelos via ai_model: meshy-t1 — o modelo atual low-poly — e meshy-t2 — um novo modelo com topology mais limpa, partes nativamente separadas, saída em triângulos e 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 a servir o tráfego para compatibilidade retroativa.

7 de Julho

  • Adicionado o parâmetro aspect_ratio à Image to Image API, para que você possa controlar a proporção de saída da imagem 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 o gpt-image-2. Opcional; o padrão é 1:1 e não pode ser combinado com generate_multi_view.

Junho 2026

17 de Junho

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

15 de Junho

  • Nova UV Unwrap API: gera um layout UV de alta qualidade para um modelo 3D existente — a etapa pré-requisito antes de texturizar ou sempre que precisar de um layout UV limpo e não sobreposto para ferramentas subsequentes. Aceita um input_task_id (uma tarefa de Imagem para 3D, Texto para 3D ou Remesh concluída) ou um model_url (.glb apenas) e retorna um "modelo branco UV" com novas coordenadas UV. 5 créditos por chamada. Suporta malhas de até 40.000 faces (execute Remesh primeiro se maior); malhas de quadrados e n-gons são trianguladas durante a geração de UV.

12 de Junho

  • Atualização nos preços 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. Veja Preços para o detalhamento completo.

5 de Junho

  • 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 também renderiza uma versão do preview com fundo transparente (RGBA) e a retorna no novo campo de resposta alpha_thumbnail_url. O existente thumbnail_url permanece inalterado. O padrão é false.

1 de Junho

  • Novas Creative Lab APIs: uma família de endpoints voltados para produtos 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 em duas etapas prototype → build encadeado via input_task_id, servido sob URLs voltados para produtos (/openapi/creative-lab/<produto>/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 2026

26 de Maio

  • Adicionado parâmetro multi_view_thumbnails à Multi-Image to 3D API. Quando definido como true, a tarefa também renderiza quatro miniaturas de visão cardinal (frente, direita, verso, 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.

22 de Maio

  • As funcionalidades de converter e redimensionar da Remesh API agora estão disponíveis como endpoints autônomos Convert API e Resize API. Os parâmetros obsoletos no Remesh continuarão a funcionar para compatibilidade retroativa.

13 de Maio

  • Adicionado parâmetro multi_view_thumbnails à Image to 3D API. Quando definido como true, a tarefa também renderiza quatro miniaturas de visão cardinal (frente, direita, verso, 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 parâmetro resize_longest_side à Remesh API. Redimensiona o modelo para que a dimensão mais longa 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 Analyze Printability API: Analise uma tarefa Meshy concluída — ou qualquer URL de modelo 3D — para prontidão de impressão 3D FDM. Padrão Async create + stream: POST retorna um task_id, então GET / SSE stream retorna métricas de vedação, volume, buracos e arestas non-manifold depois que a tarefa for SUCCEEDED. Grátis, sem consumo de créditos.
  • Nova Repair Printability API: Repare um modelo 3D para imprimibilidade FDM — corrige arestas non-manifold, faces degeneradas, buracos e outros problemas de topology. Aceita um input_task_id de Meshy existente ou um model_url (.glb, .stl, .obj). O formato de saída combina com a entrada. 10 créditos por tarefa.

Abril 2026

27 de Abril

  • Adicionado campo consumed_credits a todas as respostas de tarefa em cada endpoint de 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). Veja Preços para custos de créditos por endpoint.

24 de Abril

  • Adicionado 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 ambos model_url e input_task_id são fornecidos, input_task_id tem prioridade.

21 de Abril

  • Adicionado parâmetro input_task_id aos endpoints Image to 3D e Multi-Image to 3D. Consulte a saída de uma tarefa de Texto para Imagem ou Imagem para Imagem concluída diretamente em vez de fornecer image_url / image_urls. Quando ambos são fornecidos, input_task_id tem prioridade.

20 de Abril

14 de Abril

12 de Abril

  • Estruturação reformulada da documentação da API: adição de agrupamento de parâmetros com campos dependentes, padrões embutidos, crachás de exigidos/obsoletos, subnavegação expansível e divisão de Multi-Image, Rigging e Animação em páginas separadas.

Março 2026

2 de Abril

  • Adicionado suporte ao formato 3mf ao parâmetro target_formats em todos os endpoints (Image to 3D, Text to 3D, Remesh, Retexture). Nota: 3MF é apenas opt-in e deve ser solicitado explicitamente.
  • Nova Multi-Color Print API: Converta modelos 3D para o formato 3MF multicolorido para impressão 3D. Suporta paletas de cores de 1 a 16 com precisão configurável. 10 créditos por tarefa.

20 de Março

  • Aposentado o modelo de IA Meshy-4. Todas as solicitações de API usando 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 Image to 3D, Multi-Image to 3D, Text to 3D e Remesh. Quando auto_size está ativado, o serviço usa visão de IA para estimar a altura real e redimensionar o modelo automaticamente. origin_at define a posição de origem (bottom ou center). Na Remesh API, auto_size é mutuamente exclusivo com resize_height.

17 de Março

Fevereiro 2026

28 de Fevereiro

  • Adicionado parâmetro remove_lighting às APIs Image to 3D, Multi-Image to 3D, Text to 3D Refine e Retexture. Remove destaques e sombras da textura de cor base para resultados mais limpos sob iluminação personalizada. Suportado apenas para meshy-6 e latest. O padrão é true.
  • As APIs Retexture e Text to 3D Refine agora suportam meshy-6 como um valor de ai_model para texturização completa Meshy 6.

25 de Fevereiro

  • Adicionado parâmetro image_enhancement às APIs Image to 3D e Multi-Image to 3D para usuários que desejam optar por não otimizar a imagem de entrada e preservar a aparência exata de sua entrada. Suportado apenas para meshy-6 e latest. O padrão é true.

20 de Fevereiro

  • Adicionado parâmetro model_type à Text to 3D Preview API para gerar malhas low-poly otimizadas para polígonos mais limpos.

Janeiro 2026

27 de Janeiro

  • Adicionada documentação detalhada de Modos de Falha para todos os endpoints de API, incluindo códigos de erro HTTP comuns (400, 401, 402, 404, 422, 429) e razões para falhas de tarefas. Isso ajuda os desenvolvedores a entenderem melhor e lidarem com erros de API.

26 de Janeiro

  • A Multi-Image to 3D API agora suporta Meshy-6 para geração completa de malhas. O parâmetro ai_model agora aceita meshy-6 e latest resolve para Meshy 6.

22 de Janeiro

  • Parâmetro art_style obsoleto para a Text to 3D Preview API (Meshy-6). O parâmetro foi projetado para modelos legados (Meshy-4 / Meshy-5) e será removido em um futuro lançamento.
  • Parâmetro enable_pbr obsoleto para as APIs Text to 3D e Image to 3D quando ai_model é meshy-4. Este parâmetro será removido em uma futura versão.
  • Atualizado o valor padrão do parâmetro should_remesh para Meshy-6 nas APIs Text to 3D e Image to 3D. O parâmetro agora tem como padrão false para meshy-6, e true para outros modelos se não especificado.

19 de Janeiro

12 de Janeiro

  • Adicionado um novo parâmetro model_type à Image to 3D API para gerar malhas low-poly otimizadas para polígonos mais limpos.

Dezembro 2025

31 de Dezembro

  • Lançado o API Playground, um espaço dedicado para os desenvolvedores explorarem parâmetros de API e testarem solicitações diretamente no site da Meshy.
  • Introduzido o Text to Image API e o Image to Image API, permitindo a geração de imagens com tecnologia AI 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.

22 de Dezembro

  • O campo video_url na resposta da Text to 3D API agora está obsoleto e será removido em um futuro lançamento.

04 de Dezembro

  • Adicionado um novo parâmetro pose_mode à Text to 3D Preview, Image to 3D e Multi-Image to 3D APIs. Este parâmetro aceita a-pose, t-pose ou uma string vazia (padrão). O parâmetro is_a_t_pose agora está obsoleto em favor de pose_mode.

Novembro 2025

24 de Novembro

  • As APIs Image to 3D e Multi-Image to 3D adicionam um parâmetro opcional save_pre_remeshed_model e expõem model_urls.pre_remeshed_glb quando um backup de pré-remesh é solicitado.

06 de Novembro

  • A Text to 3D Refine API agora suporta ai_model = latest, que resolve para Meshy 6 Preview.
  • A Image to 3D API agora tem como padrão Meshy-6-preview para texturização quando ai_model = latest e should_texture = true.
  • A Multi-Image to 3D API 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 Retexture API adiciona uma opção latest para ai_model (Meshy-6-preview) e agora tem como padrão quando omitido.

04 de Novembro

  • A Remesh API agora preserva texturas para modelos enviados.
  • A Retexture API agora preserva texturas para modelos enviados quando a opção enable_original_uv está habilitada.

Outubro 2025

28 de Outubro

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

20 de Outubro

  • Adicionado um parâmetro booleano opcional convert_format_only à Remesh API para suportar a conversão apenas do formato do arquivo de modelo de entrada.
  • Adicionado rigged_character_glb_url à resposta de The Rigging Task Object.

01 de Outubro

  • Remover APIs text-to-voxel

Setembro 2025

23 de Setembro

  • Adicionada a opção latest para ai_model na Text to 3D API para usar Meshy 6 Preview.
  • Desconto temporário de 50% em vigor para tarefas de geração Meshy-6-preview para 10 créditos que vai durar até 30 de setembro de 2025. Após o período de desconto, o custo das tarefas Meshy-6-preview retornará ao normal: 20 créditos.

18 de Setembro

16 de Setembro

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

4 de Setembro

  • Suporte expandido de entrada model_url para .glb, .gltf, .obj, .fbx, .stl para Remesh e Retexture.

Agosto 2025

18 de Agosto

13 de Agosto

  • Meshy 5 agora é estável para Text to 3D e Image to 3D (ai_model: meshy-5), entregando melhor qualidade e consistência.

Julho 2025

31 de Julho

Junho 2025

25 de Junho

  • Adicionada a Retexture API, que permite aos usuários retexturizar modelos 3D baseados nos AI models mais recentes da Meshy.

19 de Junho

17 de Junho

  • Documentação adicionada para Webhooks.

10 de Junho

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

Maio 2025

20 de Maio

15 de Maio

Abril 2025

29 de Abril

  • Introduzida a Multi-Image to 3D API, permitindo geração de modelos 3D a partir de 1 a 4 imagens de entrada usando o modelo de AI meshy-5.
  • Adicionada a opção de modelo de AI meshy-5 às APIs Text to 3D e Image to 3D. A tag latest agora também resolve para meshy-5.

17 de Abril

  • Adicionado o parâmetro texture_image_url às APIs Image to 3D e Text to 3D Refine, permitindo que os usuários guiem o processo de geração de textura com uma imagem.

Março 2025

28 de Março

  • Adicionado o parâmetro latest às APIs Text to 3D e Image to 3D, permitindo acesso aos nossos modelos avançados de AI mais recentes para melhor qualidade de geração.

14 de Março

06 de Março

  • Preços atualizados para tarefas de geração de API:
    • Texto para 3D (Preview): Aumentado de 2 para 5 créditos por chamada
    • Texto para 3D (Refine): Aumentado de 5 para 10 créditos por chamada
    • Imagem para 3D: Agora 5 créditos sem textura, 15 créditos com textura
    • Texto para Textura: Aumentado de 5 para 10 créditos por chamada
    • Texto para Voxel: Permanece em 5 créditos por chamada

Fevereiro 2025

18 de Fevereiro

  • Adicionada uma chave de API no modo de teste que permite aos desenvolvedores testar a integração da API sem consumir créditos. Todas as solicitações válidas usando essa chave retornarão os mesmos resultados de tarefas de exemplo.

13 de Fevereiro

  • Mudanças de ruptura:

    • A criação de tarefas do nível gratuito terminará em 20 de março de 2025. Após isso, todas as solicitações de tarefas de API exigirão uma assinatura paga. Para manter seu acesso suave, recomendamos atualizar antes do prazo.
    • Use o código de cupom APIACCESS para desfrutar de um desconto de 40%. Obrigado por estar conosco!

  • Adicionados endpoints de streaming de Eventos Enviados pelo Servidor (SSE) para atualizações de tarefas em tempo real:

6 de Fevereiro

  • Adicionado o parâmetro texture_prompt às APIs Image to 3D e Text to 3D Refine, permitindo que os usuários guiem o processo de geração de texturas com um prompt de texto.

Janeiro 2025

23 de Janeiro

14 de Janeiro

  • APIs legadas Texto para 3D e Imagem para 3D obsoletas, alimentadas por modelos de IA Meshy-3.

07 de Janeiro

Dezembro 2024

19 de Dezembro

  • Adicionada a Remesh APIs, que permite aos usuários remesh e exportar modelos 3D existentes gerados por outras Meshy APIs em vários formatos.
  • Limites de contagem de polígonos atualizados para nossas APIs para um intervalo de 100-300.000 para usuários Premium.

12 de Dezembro

  • A propriedade model_url obsoleta em todos os objetos de resposta.
  • APIs legadas Meshy-3 separadas da mais recente Meshy-4 API.

10 de Dezembro

5 de Dezembro

3 de Dezembro

  • APIs externas agora usam o prefixo /openapi. Caminhos legados continuam suportados, mas recomendamos a mudança para os novos caminhos.

Novembro 2024

14 de Novembro