Registo de alterações

Veja todas as últimas funcionalidades e atualizações da Meshy API e plugins.

Julho 2026

27 de jul

  • Nova API Creative Lab — Figura de Blocos: transforme uma foto numa minifigura 3D colecionável ao estilo de blocos de construção. O mesmo fluxo de trabalho em duas etapas da API de Figura — prototype (6 créditos) gera uma imagem de conceito estilizada, build (30 créditos) transforma-a num modelo 3D com texturas, com saídas GLB e OBJ + MTL. Consulte Preços para o detalhe completo.

21 de jul

  • Passámos a suportar texturas de cor base em 8K através de um novo parâmetro texture_resolution (2k / 4k / 8k) nos endpoints Imagem para 3D, Multi Imagem para 3D, Texto para 3D (Refinar) e Retexturizar. Em 8k, os mapas PBR são gerados a 4K e não é produzido nenhum mapa de emissão. A geração de textura 8K custa 15 créditos (2k/4k mantêm-se em 10). Consulte os Preços.
  • O booleano hd_texture está obsoleto em favor de texture_resolution; continua a ser respeitado e equivale a texture_resolution: "4k" para compatibilidade retroativa.

20 de jul

  • Nova Creative Lab — API de Figuras de Vinil: transforme uma foto numa figura colecionável 3D de vinil com cabeça grande. Mesmo fluxo de trabalho em duas fases que a API de Figuras — prototype (6 créditos) gera uma imagem conceptual estilizada, build (30 créditos) transforma-a num modelo 3D com textura com saídas GLB e OBJ + MTL. Consulte os Preços para a divisão completa.

13 de Jul

  • Adicionado um novo model_type de Smart Topology à API Imagem para 3D, oferecendo dois modelos via ai_model: meshy-t1 — o modelo atual low-poly — e meshy-t2 — um novo modelo com topology mais limpa, partes separadas nativamente, saída em triângulos, e uma contagem de faces que pode ser definida com target_polycount. meshy-t2 é o padrão sob smart-topology. O model_type: lowpoly existente é agora obsoleto, mas continua a atender tráfego para compatibilidade retroativa.

7 de julho

  • Adicionado o parâmetro aspect_ratio à API Imagem para imagem, permitindo 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; por defeito é 1:1 e não pode ser combinado com generate_multi_view.

junho de 2026

17 de junho

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

15 de junho

  • Nova API de Desdobramento UV: gera uma disposição UV de alta qualidade para um modelo 3D existente — o passo essencial antes da texturização, ou sempre que precisar de uma disposição UV limpa, sem sobreposições, para ferramentas subsequentes. Aceita um input_task_id (uma tarefa concluída de Imagem para 3D, Texto para 3D, ou Remesh) 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 for maior); malhas quad e n-gon são trianguladas durante a geração UV.

12 de jun

  • Atualizado o Preços da Creative Lab API Build para 30 créditos por chamada para porta-chaves, íman de frigorífico, e figura (anteriormente 20). candeeiro mantém-se inalterado em 30 créditos. O preço do protótipo mantém-se inalterado em 6 créditos por imagem. Consulte Preços para a divisão completa.

Jun 5

1 de jun

  • Novos APIs do Creative Lab: uma família de endpoints concentrados em produtos que transformam uma fotografia fonte (ou texto prompt) num produto de consumo imprimível em 3D. Quatro produtos no lançamento — porta-chaves, íman de frigorífico, figura e candeeiro. Cada um segue um fluxo de trabalho em duas etapas prototype → build encadeado via input_task_id, servido sob URLs concentradas em produtos (/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 definido como true, a tarefa renderiza adicionalmente quatro miniaturas de vista cardinal (frente, direita, trás, esquerda) e retorna-as sob o novo campo de resposta thumbnail_urls. O campo thumbnail_url existente permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.

22 de Maio

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

13 de Maio

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

12 de maio

  • Adicionado parâmetro resize_longest_side à API Remesh. 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 API de Analisar Imprimibilidade: Analise uma tarefa Meshy sucedida — ou qualquer URL de modelo 3D — para verificar a prontidão para impressão 3D FDM. Padrão de criação assíncrona + transmissão: o POST retorna um task_id, depois o GET / SSE transmite dados sobre hermeticidade, volume, orifícios e métricas de arestas non-manifold assim 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, orifícios e outros problemas topológicos. Aceita um input_task_id existente do Meshy ou um model_url (.glb, .stl, .obj). O formato de saída corresponde ao de entrada. 10 créditos por tarefa.

Abril 2026

27 Abr

  • Adicionado o campo consumed_credits a todas as respostas de tarefas em cada endpoint da API. Mostra o número de créditos consumidos por cada tarefa. O campo está presente para tarefas nos estados PENDING, IN_PROGRESS e SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são automaticamente reembolsados em caso de falha). Consulte Preços para ver os custos de créditos por endpoint.

24 de abril

  • Adicionado o parâmetro model_url ao endpoint Impressão Multicor. Submeta um modelo 3D com textura diretamente (via URL ou Data URI) em vez de um input_task_id de uma tarefa anterior do Meshy. 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 de 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.

20 de abril

Apr 14

12 de abr

  • Reestruturada a documentação da API: adicionado agrupamento de parâmetros com campos dependentes, padrões inline, insígnias de requerido/obsoleto, sub-navegação expansível, e divididos Multi-Image, Rigging e Animação em páginas separadas.

Março 2026

2 de Abril

  • Suporte ao formato 3mf adicionado ao parâmetro target_formats em todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: 3MF é opcional e deve ser explicitamente solicitado.
  • Nova API de Impressão Multicor: Converta modelos 3D para o formato 3MF multicor para impressão 3D. Suporta paletas de 1 a 16 cores com precisão configurável. 10 créditos por tarefa.

20 de março

  • Retirado o modelo AI Meshy-4. Todos os pedidos API que utilizavam meshy-4 não são mais suportados. 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 AI para estimar a altura real e redimensionar o modelo automaticamente. origin_at define a posição da origem (bottom ou center). Na API Remesh, auto_size é mutuamente exclusivo com resize_height.

Mar 17

Fevereiro 2026

28 de fevereiro

Fev 25

  • Adicionado o parâmetro image_enhancement às APIs Imagem para 3D e Multi-imagem para 3D para utilizadores que desejam não participar na otimização da imagem de entrada e preservar a aparência exata da sua entrada. Suportado apenas para meshy-6 e latest. Por defeito, está definido como true.

Feb 20

  • Adicionado o parâmetro model_type na API de Texto para 3D Preview para gerar malhas low-poly otimizadas para polígonos mais limpos.

Janeiro 2026

27 de Janeiro

  • Adicionada documentação detalhada dos Modes 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 tarefas. Isso ajuda os desenvolvedores a compreenderem e lidarem melhor com os erros da API.

26 de Janeiro

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

22 de Jan

  • O parâmetro art_style está obsoleto para a API Texto para 3D Preview (Meshy-6). O parâmetro foi projetado para modelos legados (Meshy-4 / Meshy-5) e será removido numa versão futura.
  • O parâmetro enable_pbr está obsoleto para as APIs Texto para 3D e Imagem para 3D quando ai_model é meshy-4. Este parâmetro será removido numa versão futura.
  • Atualizado o valor padrão do parâmetro should_remesh para 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, se não especificado.

Jan 19

Jan 12

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

Dezembro 2025

Dec 31

  • Lançado o API Playground, um espaço dedicado para desenvolvedores explorarem parâmetros de API e testarem pedidos diretamente no site da Meshy.
  • Introduzimos a Texto para Imagem API e a 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 opção de geração multivista.

22 Dez

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

04 de Dez

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 é solicitado um backup pré-Remesh.

Nov 06

  • A API de Texto para 3D agora suporta ai_model = latest, que se refere ao Meshy 6 Preview.
  • A API de Imagem para 3D agora utiliza por padrão o mapeamento 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 mapeamento de texturas por padrão, enquanto a geração de malha permanece como Meshy-5.
  • A API de Retexturizar adiciona uma opção latest para ai_model (Meshy-6-preview) que agora é a predefinida quando omitida.

Nov 04

  • A API de Remesh agora preserva texturas para modelos carregados.
  • A API de Retexturizar agora preserva texturas para modelos carregados quando a opção enable_original_uv está ativada.

Outubro 2025

Oct 28

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

20 de outubro

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

01 de Outubro

  • Remover APIs text-to-voxel

Setembro 2025

23 de Setembro

  • 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 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 voltará ao normal de 20 créditos.

18 de set

16 de setembro

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

4 de Set

  • Expansão do suporte de entrada de model_url para .glb, .gltf, .obj, .fbx, .stl para Remesh e Retexturizar.

Agosto 2025

18 de agosto

13 Ago

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

Julho 2025

Jul 31

Junho 2025

Jun 25

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

Jun 19

17 de jun

  • Adicionada documentação para Webhooks.

Jun 10

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

Maio de 2025

20 de maio

15 de maio

  • Introduzida a API de Auto-rigging e Animação, permitindo que os utilizadores façam o rig e a animação automáticos de modelos 3D. Saiba mais sobre Rigging e Animação.

Abril 2025

29 de abril

  • Introduzida a API 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 Texto para 3D e Imagem para 3D. A tag latest agora também resolve para meshy-5.

Apr 17

  • Adicionado o parâmetro texture_image_url às APIs de Imagem para 3D e Refinar Texto para 3D, permitindo que os utilizadores guiem o processo de geração de textura com uma imagem.

Março de 2025

28 de Março

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

14 de março

06 Mar

  • Atualização dos preços para tarefas de geração de API:
    • Texto para 3D (Pré-visualização): 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 2025

18 de Fevereiro

  • Adicionada uma chave de API do modo de teste msy_dummy_api_key_for_test_mode_12345678 que permite aos programadores testar a integração da API sem consumir créditos. Todos os pedidos válidos usando esta chave retornarão os mesmos resultados de tarefa de exemplo.

13 de fevereiro

  • Alterações Críticas:

    • A criação de tarefas no nível gratuito terminará em 20 de março de 2025. Após essa data, todos os pedidos de tarefas da API necessitarão de uma subscrição paga. Para manter o seu acesso sem interrupções, recomendamos a atualização antes do prazo limite.
    • Utilize o código de cupão APIACCESS para usufruir de um desconto de 40%. Obrigado por estar connosco!

  • Adicionados endpoints de streaming SSE (Server-Sent Events) 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 utilizadores orientem o processo de geração de textura com um prompt de texto.

Janeiro 2025

Jan 23

Jan 14

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

Jan 07

Dezembro 2024

19 de dez

  • Adição das APIs de Remesh, que permitem aos utilizadores remesh e exportar modelos 3D existentes gerados por outras APIs da Meshy em vários formatos.
  • Atualização dos limites de contagem de polígonos para as nossas APIs para um intervalo de 100-300,000 para utilizadores Premium.

12 de dezembro

  • Propriedade model_url obsoleta em todos os objetos de resposta.
  • API Meshy-3 Legacy separada da API Meshy-4 mais recente.

Dec 10

5 de Dezembro

3 de dezembro

  • As APIs externas agora usam o prefixo /openapi. Os caminhos Legacy continuam a ser suportados, mas recomendamos a mudança para os novos caminhos.

Novembro 2024

14 de nov