Registro de alterações

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

Julho 2026

20 de jul

  • Novo Creative Lab — API de Figura de Vinil: transforme uma foto em uma figura colecionável de vinil 3D com cabeça grande. O mesmo fluxo de trabalho em duas etapas da API de Figura — prototype (6 créditos) gera uma imagem conceitual estilizada, build (30 créditos) transforma-a em um modelo 3D com textura e saídas GLB e OBJ + MTL. Veja Preços para a descrição completa.

Jul 13

  • Adicionado um novo model_type de 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 pode ser definida com target_polycount. meshy-t2 é o padrão em smart-topology. O model_type: lowpoly existente agora está obsoleto, mas continua a atender o tráfego para compatibilidade retroativa.

7 de jul

  • Adicionado o parâmetro aspect_ratio à API de Imagem para imagem, permitindo que você controle 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 2026

17 de jun

  • Nova página de documentação do API Playground: um console interativo para experimentar endpoints sem escrever código, e depois copiar o equivalente em cURL, Python ou JavaScript. 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 — o passo preliminar antes de texturização, ou sempre que você precisar de um layout UV limpo e sem sobreposição para ferramentas posteriores. Aceita um input_task_id (uma tarefa concluída de Imagem para 3D, Texto para 3D ou Remesh) ou um model_url (somente .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 o Remesh primeiro se for maior); malhas quad e n-gon são trianguladas durante a geração UV.

12 de jun

  • Atualizado o preço de Build da API do Creative Lab para 30 créditos por chamada para chaveiro, ímã de geladeira e figura (anteriormente 20). Luminária permanece inalterado em 30 créditos. O preço do protótipo permanece inalterado em 6 créditos por imagem. Veja Preços para a divisão completa.

Jun 5

1 de jun

  • Novas APIs do Creative Lab: uma família de endpoints com escopo de produto que transformam uma foto fonte (ou prompt de texto) em um produto de consumo imprimível em 3D. Quatro produtos no lançamento — chaveiro, ímã de geladeira, figura, e luminária. Cada um segue um fluxo de trabalho em duas etapas prototype → build encadeado via input_task_id, servido 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. Protótipo: 6 créditos por chamada. Construção: 30 créditos por chamada.

Maio 2026

26 de maio

  • Adicionado o parâmetro multi_view_thumbnails à API Multi-imagem para 3D. Quando configurado como true, a tarefa renderiza adicionalmente quatro miniaturas de visualização cardinal (frente, direita, trás, 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

  • A funcionalidade de converter e redimensionar da Remesh API agora está disponível como Convert API e Resize API endpoints independentes. Os parâmetros obsoletos no Remesh continuarão a funcionar para compatibilidade retroativa.

13 de maio

  • Adicionado o parâmetro multi_view_thumbnails à API de Imagem para 3D. Quando definido como true, a tarefa renderiza adicionalmente miniaturas de quatro vistas cardeais (frontal, direita, traseira, esquerda) e as retorna sob o novo campo de resposta thumbnail_urls. O campo existente thumbnail_url permanece inalterado. Adiciona aproximadamente 3 segundos à latência da tarefa.

12 de maio

  • Adicionado 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 de Analisar Imprimibilidade: Analise uma tarefa Meshy sucedida — ou qualquer URL de modelo 3D — para prontidão de impressão 3D FDM. Padrão de criação assíncrona + transmissão: POST retorna um task_id, então GET / fluxo SSE retorna métricas de estanqueidade, volume, buracos e arestas non-manifold uma vez que SUCCEEDED. Gratuito, sem consumo de créditos.
  • Nova API de 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_id Meshy existente ou um model_url (.glb, .stl, .obj). O formato de saída corresponde ao de entrada. 10 créditos por tarefa.

Abril 2026

Abr 27

  • 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 automaticamente reembolsados em caso de falha). Veja Preços para custos de créditos por endpoint.

24 de abr

  • Adicionado o parâmetro model_url ao endpoint de Impressão Multicolorida. Submeta um modelo 3D com textura 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 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

14 de abril

12 de abril

  • Reestruturada a documentação da API: adicionado agrupamento de parâmetros com campos dependentes, padrões inline, selos de obrigatório/obsoleto, subnavegação expansível e divisão de Multi-Imagem, Rigging e Animação em páginas separadas.

Março de 2026

2 de abril

  • Adicionado suporte ao formato 3mf para o parâmetro target_formats em todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: 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 cores de 1 a 16 com precisão configurável. 10 créditos por tarefa.

20 de mar

  • O modelo de IA Meshy-4 foi descontinuado. Todas as solicitações de API utilizando 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á ativado, o serviço utiliza 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 API Remesh, auto_size é mutuamente exclusivo com resize_height.

17 de mar

Fevereiro 2026

Fev 28

25 de fev

  • Adicionado o parâmetro image_enhancement às APIs Imagem para 3D e Multi-imagem para 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.

Feb 20

Janeiro 2026

27 de Jan

  • 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 razões de falha de tarefa. Isso ajuda os desenvolvedores a compreenderem e lidarem melhor com os erros da API.

26 de jan

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

Jan 22

  • art_style obsoleto para a API de Texto para 3D Preview (Meshy-6). O parâmetro foi projetado para modelos legados (Meshy-4 / Meshy-5) e será removido em uma futura versão.
  • enable_pbr obsoleto para as APIs de Texto para 3D e Imagem para 3D quando ai_model é meshy-4. Este parâmetro será removido em uma futura versão.
  • Valor padrão atualizado do parâmetro should_remesh para Meshy-6 nas APIs de Texto para 3D e Imagem para 3D. O parâmetro agora é padrão false para meshy-6, e true para outros modelos, se não especificado.

Jan 19

12 de Jan

  • Adicionado um novo parâmetro model_type à API Imagem para 3D 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 desenvolvedores explorarem parâmetros da API e testarem solicitações diretamente no site da Meshy.
  • Introduzido o Texto para imagem API e Imagem para imagem API, permitindo a geração de imagens com tecnologia de 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 opcional de multivista.

22 de Dez

  • O campo video_url na resposta da API de 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 Texto para 3D, Imagem para 3D e Multi-imagem para 3D. 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 nov

  • 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 Texto para 3D agora suporta ai_model = latest, que se resolve para Meshy 6 Preview.
  • A API de Imagem para 3D agora tem como padrão a aplicação de texturas 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 a aplicação de texturas 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 assume esse padrão quando omitido.

Nov 04

  • A API de Remesh agora preserva textures para os modelos enviados.
  • A API de Retexturizar agora preserva textures para os modelos enviados quando a opção enable_original_uv está habilitada.

Outubro de 2025

28 de outubro

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

20 de outubro

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

01 de Out

  • Remover APIs text-to-voxel

Setembro 2025

23 de setembro

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

18 de Set

Sep 16

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

4 de setembro

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

Agosto de 2025

18 de Agosto

Aug 13

  • Meshy 5 agora está estável para Texto para 3D e Imagem para 3D (ai_model: meshy-5), oferecendo qualidade e consistência aprimoradas.

Julho 2025

Jul 31

Junho 2025

Jun 25

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

19 de jun

17 de Jun

  • Adicionada documentação para Webhooks.

10 de jun

  • A API de Remesh agora suporta modelos no 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 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 resolve para meshy-5.

17 de abril

  • Adicionado o parâmetro texture_image_url às APIs Imagem para 3D e Texto para 3D Refine, permitindo aos usuários guiar o processo de geração de textura com uma imagem.

Março de 2025

28 de mar

  • Adicionado o parâmetro latest às APIs de Texto para 3D e Imagem para 3D, permitindo acesso aos nossos próximos modelos avançados de IA para uma qualidade de geração aprimorada.

14 de Mar

Mar 06

  • Preços atualizados para tarefas de geração de API:
    • Texto para 3D (Prévia): Aumentado de 2 para 5 créditos por chamada
    • Texto para 3D (Refinar): 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 de 2025

Feb 18

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

13 de fevereiro

  • Alterações Importantes:

    • A criação de tarefas no nível gratuito terminará em 20 de março de 2025. Após essa data, todas as requisições de tarefas na API exigirão uma assinatura paga. Para manter seu acesso fluindo, recomendamos fazer o upgrade 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 Server-Sent Events (SSE) para atualizações de tarefas em tempo real:

6 de Fev

  • Adicionado o parâmetro texture_prompt às APIs Imagem para 3D e Texto para 3D Refine, permitindo que os usuários direcionem o processo de geração de textura com um prompt de texto.

Janeiro 2025

23 de Jan

Jan 14

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

Jan 07

Dezembro 2024

19 de dezembro

  • Adicionadas as APIs de Remesh, que permitem aos usuários remesh e exportar modelos 3D existentes gerados por outras APIs Meshy em vários formatos.
  • Atualizados os limites de contagem de polígonos para nossas APIs para um intervalo de 100-300.000 para usuários Premium.

12 de Dez

  • Tornou obsoleto a propriedade model_url em todos os objetos de resposta.
  • Separou a API legado Meshy-3 da última API Meshy-4.

10 de Dez

5 de Dezembro

Dec 3

  • APIs externos agora usam o prefixo /openapi. Caminhos Legacy ainda são suportados, mas recomendamos mudar para os novos caminhos.

Novembro 2024

14 de Nov