Registo de alterações

Veja todas as funcionalidades e atualizações mais recentes da Meshy API e dos plugins.

Setembro 2026

Sep 3

  • O estágio de protótipo da Creative Lab Lamp API devolve agora um modelo 3D: POST /prototype transforma a imagem do conceito num GLB de candeeiro oco, e o objeto de tarefa do protótipo passa a incluir model_urls.glb e thumbnail_url juntamente com image_urls. O estágio de construção executa apenas o processador de candeeiro nesse modelo e agora produz um candeeiro de fundo aberto com uma placa de base para a fixação da fonte de luz. Os Preços acompanham a alteração do trabalho: o protótipo passa a custar 30 créditos e a construção 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: ativa a geração Ultra no ai_model meshy-7 (ou latest) para uma geometria de maior fidelidade com detalhe de superfície mais fino, por 5 créditos adicionais — o mesmo processamento Ultra que a API de Imagem para 3D oferece, agora disponível com entradas multivista.
  • Removido o meshy-t1 dos valores de ai_model documentados para o model_type Smart Topology da API de Imagem para 3D. O Smart Topology agora só documenta o meshy-t2; as novas integrações devem utilizá-lo. O Meshy T1 está previsto para descontinuação — se a sua integração enviar atualmente ai_model: "meshy-t1", migre para meshy-t2.

Agosto de 2026

Aug 28

  • Adicionada a Usage API para equipas Studio e Enterprise: exporte programaticamente o histórico de utilização de tarefas da API — endpoint, estado, marcas temporais, a chave de API que executou cada tarefa, e consumed_credits — com paginação padrão e filtros de intervalo de tempo, endpoint e estado, para efeitos de acompanhamento de custos e sistemas financeiros.

Aug 26

  • A Animation API aceita agora 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. Os mesmos 3 créditos por tarefa.

24 de Ago

  • Alargou o suporte de aspect_ratio para gpt-image-2 nas APIs Texto para imagem e Imagem para imagem, acrescentando 16:9 e 9:16. O gpt-image-2 aceita agora 1:1, 16:9, 9:16, 3:2 e 2:3; 4:3 e 3:4 continuam por suportar neste modelo.

21 de Ago

  • 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 um 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ções de clipe de 2 a 10 segundos.

Aug 20

  • Adicionado o parâmetro style à Multi-Color Print API: escolha realistic (predefinição) para cores fiéis à textura, ou cartoon para regiões de cor planas e uniformes e um 3MF mais pequeno.
  • 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 Multi-imagem para 3D: forneça 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

Aug 13

  • Adicionado ai_model: "meshy-7" à API de Texto para 3D: o nosso mais recente modelo de geração 3D, com uma geometria de maior fidelidade do que o Meshy 6. Introduz também o parâmetro ultra_mode na tarefa de preview, que ativa a geração Ultra para um detalhe de superfície ainda mais fino por 5 créditos adicionais. Para aplicar textura com o Meshy 7, indique ai_model: "meshy-7" na tarefa refine ou omita ai_model por completo.
  • 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 um número de faces que pode definir com target_polycount (100 a 15 000, valor predefinido 4000). Um preview de Smart Topology custa 5 créditos em vez de 20; consulte Preços. O model_type: "lowpoly" existente está agora obsoleto, mas continua a servir tráfego por motivos de compatibilidade com versões anteriores.

Aug 12

  • Adicionado ai_model: "meshy-7" à API de Imagem para 3D: o nosso mais recente modelo de geração de 3D, com geometria de maior fidelidade do que o Meshy 6. Também introduz o parâmetro ultra_mode, que ativa a geração Ultra para um detalhe 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 orienta a texturização a partir delas.
  • Adicionado ai_model: "meshy-7" à API de Retexturizar: o nosso mais recente modelo de texturização, com um detalhe de superfície mais nítido e materiais PBR mais limpos do que o Meshy 6. Também introduz o parâmetro multiview_image_urls — forneça de 1 a 4 vistas ordenadas do mesmo objeto para orientar a texturização multivista.

Aug 4

  • Suporte alargado para model_url de entrada para .glb, .gltf, .obj, .fbx, .stl nos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente .glb, .stl, .obj). A reparação devolve o asset reparado no seu formato de entrada.

July 2026

Jul 27

  • Novo Creative Lab — Brick Figure API: transforme uma fotografia numa figura 3D colecionável em estilo de blocos (minifigura). O mesmo fluxo de trabalho em duas etapas que a Figure API — prototype (6 créditos) gera uma imagem de conceito estilizada, build (30 créditos) transforma-a num modelo 3D texturizado com saídas em GLB e OBJ + MTL. Consulte Preços para a descrição completa.

Jul 22

  • Nova Creative Lab — Keycap API: transforma uma fotografia numa keycap personalizada a cores para teclado mecânico, em 3D. Fluxo de trabalho em duas fases — prototype (12 créditos) gera uma renderização do design final da keycap, e depois build (50 créditos) transforma o design escolhido (através de candidate_id) num modelo 3D de keycap com textura, com saídas em pacote GLB e OBJ, exportado à escala real em milímetros. Atualmente suporta a base padrão Cherry MX 1u (cherry-mx-1x1-r1); estão planeados mais tamanhos padrão. Consulte Preços para o detalhe completo.

Jul 21

  • Agora suportamos texturas base color 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 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 Pricing.
  • O booleano hd_texture está obsoleto em favor de texture_resolution — continua a ser respeitado e é equivalente a texture_resolution: "4k" para efeitos de compatibilidade com versões anteriores.

Jul 20

  • Nova API do Creative Lab — Figura de Vinil: transforma uma fotografia numa figura colecionável 3D de vinil com cabeça grande. O mesmo fluxo de trabalho em duas fases da API Figure — prototype (6 créditos) gera uma imagem conceptual estilizada, build (30 créditos) transforma-a num modelo 3D texturizado com resultados em GLB e OBJ + MTL. Consulte Preços para a discriminação completa.

Jul 13

  • Adicionado um novo model_type Smart Topology à API Imagem para 3D, oferecendo dois modelos através de ai_model: meshy-t1 — o modelo low-poly atual — e meshy-t2 — um novo modelo com topology mais limpa, partes nativamente separadas, resultado em triângulos e uma contagem de faces que pode definir com target_polycount. O meshy-t2 é a predefinição em smart-topology. O model_type: lowpoly existente está agora obsoleto, mas continua a servir tráfego para compatibilidade com versões anteriores.

Jul 7

  • Adicionado o parâmetro aspect_ratio à API Imagem para imagem, para que possa controlar o rácio 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 o gpt-image-2. Opcional; o valor predefinido é 1:1, e não pode ser combinado com generate_multi_view.

June 2026

Jun 17

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

Jun 15

  • Novo API de Desdobramento UV: gera uma disposição UV de alta qualidade para um modelo 3D existente — o passo obrigatório antes da texturização, ou sempre que precisar de uma disposição UV limpa e 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 (apenas .glb) e devolve um "modelo branco UV" com coordenadas UV totalmente novas. 5 créditos por chamada. Suporta malhas com até 40 000 faces (execute primeiro o Remesh se forem maiores); malhas com quadriláteros e n-gons são trianguladas durante a geração 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). O Lamp mantém-se inalterado em 30 créditos. O preço de Prototype mantém-se inalterado em 6 créditos por imagem. Consulte Preços para a discriminação completa.

Jun 5

Jun 1

  • Novas Creative Lab APIs: uma família de endpoints específicos por produto que transformam uma fotografia de origem (ou um prompt de texto) num 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 fases prototype → build, encadeadas através de input_task_id, disponibilizadas sob URLs específicos por 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 de Multi-imagem para 3D. Quando definido como true, a tarefa renderiza adicionalmente quatro thumbnails de vista cardinal (frente, direita, trás, esquerda) e devolve-as no novo campo de resposta thumbnail_urls. O campo thumbnail_url existente mantém-se inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.

May 22

  • A funcionalidade de conversão e redimensionamento da API Remesh está agora disponível como endpoints autónomos API Converter e API Redimensionar. Os parâmetros obsoletos no Remesh continuarão a funcionar para efeitos de 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 vista cardeal (frente, direita, trás, esquerda) e devolve-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 o parâmetro resize_longest_side à API Remesh. Redimensiona o modelo de forma a 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 Analisar imprimibilidade API: Analise uma tarefa Meshy bem-sucedida — ou qualquer URL de modelo 3D — quanto à preparação para impressão 3D FDM. Padrão assíncrono de criação + stream: o POST devolve um task_id, e depois o GET / stream SSE devolvem métricas de estanquidade, volume, buracos e arestas non-manifold assim que o estado for SUCCEEDED. Gratuito, não consome créditos.
  • Nova Reparar imprimibilidade API: Repare um modelo 3D para imprimibilidade FDM — corrija arestas non-manifold, faces degeneradas, buracos e outros problemas de topology. Aceita um input_task_id de uma Meshy existente 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 estados PENDING, IN_PROGRESS e SUCCEEDED. Devolve 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. Submeta um modelo 3D texturizado diretamente (através de URL ou Data URI) em vez de um input_task_id de uma tarefa Meshy anterior. Formatos suportados: .glb, .fbx. Quando são fornecidos tanto model_url como input_task_id, o 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 ao resultado de uma tarefa Texto para imagem ou Imagem para imagem concluída, em vez de fornecer image_url / image_urls. Quando ambos são fornecidos, input_task_id tem prioridade.

Apr 20

14 abr

12 abr

  • Reestruturada a documentação da API: adicionado agrupamento de parâmetros com campos dependentes, valores predefinidos em linha, distintivos 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 no parâmetro target_formats em todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: o 3MF é apenas opcional e tem de ser explicitamente solicitado.
  • Nova API de Impressão Multicor: Converter 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.

Mar 20

  • Descontinuado o modelo de IA Meshy-4. Todos os pedidos de API que utilizem meshy-4 deixaram de ser 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 por IA para estimar a altura real do objeto e redimensiona o modelo automaticamente. O 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 Imagem para 3D e Multi-imagem para 3D para os utilizadores que pretendam não usar a otimização da imagem de entrada e preservar o aspeto exato da sua entrada. Apenas suportado para meshy-6 e latest. O valor predefinido é true.

Feb 20

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

Janeiro 2026

Jan 27

  • Adicionada documentação detalhada sobre 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. Isto ajuda os programadores a compreender e a lidar melhor com 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 resolve para o Meshy 6.

Jan 22

  • Obsoleto o art_style para a API de Pré-visualização de Texto para 3D (Meshy-6). O parâmetro foi concebido para modelos Legacy (Meshy-4 / Meshy-5) e será removido numa versão futura.
  • Obsoleto o enable_pbr 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 predefinido do parâmetro should_remesh para o Meshy-6 nas APIs Texto para 3D e Imagem para 3D. O parâmetro assume agora o valor predefinido false para o meshy-6, e true para os restantes modelos caso não seja especificado.

19 de jan

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 de 2025

31 de dez

  • Lançado o API Playground, um espaço dedicado para os programadores explorarem os parâmetros da API e testarem pedidos diretamente no website da Meshy.
  • Introduzidas as APIs Texto para imagem e Imagem para imagem, permitindo a geração de imagens com IA a partir de instruções 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 está agora obsoleto e será removido numa versão futura.

Dec 04

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

Novembro de 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 é solicitada uma cópia de segurança pré-remesh.

Nov 06

  • A API de Refine do Texto para 3D suporta agora ai_model = latest, que corresponde ao Meshy 6 Preview.
  • A API de Imagem para 3D utiliza agora por predefinição a texturização Meshy-6-preview quando ai_model = latest e should_texture = true.
  • A API de Multi-imagem para 3D suporta agora ai_model = latest, executando o Meshy-6-preview para texturização por predefiniçã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 utiliza-a agora por predefinição quando omitida.

Nov 04

  • A API Remesh agora preserva as texturas para modelos carregados.
  • A API Retexturizar agora preserva as 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 da API.

Oct 20

  • Adicionado um parâmetro booleano opcional convert_format_only à API Remesh para suportar a conversão do formato do ficheiro do modelo de entrada apenas.
  • Adicionado rigged_character_glb_url à resposta do Objeto da 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 as tarefas de geração 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 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 Imagem para 3D para utilizar o Meshy 6 Preview.

Sep 4

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

Agosto de 2025

Aug 18

13 ago

Julho 2025

31 jul

Junho 2025

Jun 25

  • Adicionada a API de Retexturizar, que permite aos utilizadores retexturizar modelos 3D com base nos mais recentes modelos de IA fundacionais da Meshy.

Jun 19

Jun 17

  • Adicionada documentação para Webhooks.

10 jun

  • A API de Remesh suporta agora modelos GLB codificados em base64 no parâmetro model_url através de Data URI.

maio de 2025

20 mai

15 de maio

  • Foi introduzida a API de Auto-rigging & Animação, que permite aos utilizadores criar automaticamente o rig e animar modelos 3D. Saiba mais sobre Rigging e Animação.

Abril de 2025

29 de abril

  • Foi introduzida a API de Multi-imagem para 3D, que permite a geração de modelos 3D a partir de 1 a 4 imagens de entrada utilizando o modelo de IA meshy-5.
  • Foi 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 corresponde a meshy-5.

Apr 17

  • Adicionado o parâmetro texture_image_url às APIs Imagem para 3D e Texto para 3D Refine, permitindo aos utilizadores orientar o processo de geração de texturas com uma imagem.

Março de 2025

Mar 28

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

14 mar

06 mar

  • Preços atualizados para as tarefas de geração via 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: Mantém-se em 5 créditos por chamada

Fevereiro 2025

Feb 18

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

Feb 13

  • Alterações Estruturais:

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

  • 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 aos utilizadores orientar o processo de geração de textura com um prompt de texto.

January 2025

Jan 23

Jan 14

  • Foi obsoleto o uso das APIs legadas de Texto para 3D e Imagem para 3D, alimentadas pelos modelos de IA Meshy-3.

Jan 07

Dezembro de 2024

Dec 19

  • Adicionadas as Remesh APIs, que permitem aos utilizadores fazer remesh e exportar modelos 3D já gerados por outras APIs da Meshy para vários formatos.
  • Atualizados os limites de contagem de polígonos das nossas APIs para um intervalo de 100-300 000 para utilizadores Premium.

Dec 12

  • Tornou obsoleta a propriedade model_url em todos os objetos de resposta.
  • Separou a API legada Meshy-3 da mais recente API Meshy-4.

Dec 10

Dec 5

Dec 3

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

November 2024

Nov 14