Registo de alterações

Consulte 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 API do candeeiro Creative Lab devolve agora um modelo 3D: POST /prototype transforma a imagem concetual num GLB de quebra-luzes 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 sobre esse modelo e produz agora um quebra-luzes com fundo aberto e uma placa de base para a fixação da fonte de luz. Os Preços acompanham o trabalho: o protótipo custa 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 é obrigatório.

Sep 1

  • Adicionado o parâmetro ultra_mode à Multi-imagem para 3D API: permite ativar a geração Ultra no ai_model meshy-7 (ou latest) para uma geometria de maior fidelidade com detalhes de superfície mais refinados, por mais 5 créditos — o mesmo processo Ultra que a Imagem para 3D API já oferece, agora disponível com entradas Multivista.
  • Removido meshy-t1 dos valores de ai_model documentados para o model_type de Smart Topology da Imagem para 3D API. O Smart Topology agora apenas documenta meshy-t2; as novas integrações devem utilizar este último. 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

  • Foi adicionada a Usage API para equipas Studio e Enterprise: exportar programaticamente o histórico de utilização de tarefas da API — endpoint, estado, datas/horas, a chave de API que executou cada tarefa, e consumed_credits — com paginação padrão e filtros por intervalo de tempo, endpoint e estado, para acompanhamento de custos e sistemas financeiros.

Aug 26

  • A Animation API aceita agora motion_task_id — aplique um clip de movimento gerado com a Text to Motion API sobre a sua personagem bípede com rig, como alternativa a um action_id predefinido. Os mesmos 3 créditos por tarefa.

24 de agosto

  • Alargado o suporte de aspect_ratio para gpt-image-2 nas APIs Texto para imagem e Imagem para imagem para incluir 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 sem suporte para este modelo.

21 de agosto

  • 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 FBX) para a mais alta qualidade ou o mode swift (3 créditos, saída 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 de menor dimensão.
  • Adicionado o parâmetro remove_background a todos os endpoints de protótipo da 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 aplicação de texturas, 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: o nosso mais recente modelo de geração 3D, com geometria de maior fidelidade do que o Meshy 6. Introduz também o parâmetro ultra_mode na tarefa de pré-visualização, 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 de refinamento ou omita ai_model por completo.
  • 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 pode definir com target_polycount (100 a 15.000, valor predefinido de 4.000). Uma pré-visualização Smart Topology custa 5 créditos em vez de 20; consulte Preços. O model_type: "lowpoly" existente está agora obsoleto, mas continua a atender pedidos para efeitos de compatibilidade retroativa.

Aug 12

  • Adicionado ai_model: "meshy-7" à API Imagem para 3D: o nosso mais recente modelo de geração 3D, com geometria de maior fidelidade do que o Meshy 6. Introduz também 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 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 Retexturizar: o nosso mais recente modelo de texturização, com detalhe de superfície mais nítido e materiais PBR mais limpos do que o Meshy 6. Introduz também 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 a entrada model_url para .glb, .gltf, .obj, .fbx, .stl nos endpoints Analisar imprimibilidade e Reparar imprimibilidade (anteriormente .glb, .stl, .obj). A reparação devolve o ativo reparado no formato de entrada.

July 2026

Jul 27

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

Jul 22

  • Novo Creative Lab — Keycap API: transforma uma fotografia numa keycap personalizada a cores para teclado mecânico, totalmente em 3D. Fluxo de trabalho em duas etapas — prototype (12 créditos) gera uma renderização do design final da keycap e, em seguida, build (50 créditos) transforma o design escolhido (através de candidate_id) num modelo 3D de keycap com textura, com resultados em pacote GLB e OBJ, exportados à 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 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 Refine e Retexturizar. No modo 8k, os mapas PBR são gerados em 4K e não é produzido nenhum mapa de emissão. A geração de textura em 8K custa 15 créditos (2k/4k mantêm-se em 10). Consulte Preços.
  • 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 Creative Lab — Vinyl Figure API: transforma uma fotografia numa figura colecionável 3D vinyl de cabeça grande. Mesmo fluxo de trabalho em duas fases da Figure API — prototype (6 créditos) gera uma imagem conceptual estilizada, build (30 créditos) transforma-a num modelo 3D com textura e resultados em GLB e OBJ + MTL. Consulte Preços para o detalhe completo.

Jul 13

  • Adicionado um novo model_type Smart Topology à API de Imagem para 3D, disponibilizando 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 um número de faces que pode definir com target_polycount. meshy-t2 é a predefinição em smart-topology. O model_type: lowpoly existente está agora obsoleto, mas continua a servir tráfego para compatibilidade retroativa.

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 gpt-image-2. Opcional; o valor predefinido é 1:1, e não pode ser combinado com generate_multi_view.

Junho de 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 equivalente em cURL, Python ou JavaScript. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.

Jun 15

  • Novo UV Unwrap API: gera uma disposição UV de alta qualidade para um modelo 3D existente — o passo prévio necessário antes da texturização, ou sempre que precisar de uma disposição UV limpa e sem sobreposições para ferramentas a jusante. 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

  • Atualização dos preços 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. Os preços do Prototype mantêm-se inalterados em 6 créditos por imagem. Consulte Preços para a discriminação completa.

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 gera adicionalmente uma versão com fundo transparente (RGBA) da pré-visualização e devolve-a no novo campo de resposta alpha_thumbnail_url. O campo thumbnail_url existente mantém-se inalterado. O valor predefinido é false.

Jun 1

  • Novas APIs Creative Lab: uma família de endpoints com âmbito de produto que transformam uma foto de origem (ou um prompt de texto) num produto de consumo pronto a imprimir 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, encadeado através de input_task_id, disponibilizado sob URLs com âmbito de 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 2026

May 26

  • Adicionado o parâmetro multi_view_thumbnails à API Multi-imagem para 3D. Quando definido como true, a tarefa passa também a renderizar quatro miniaturas de vistas cardeais (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.

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 compatibilidade com versões anteriores.

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 (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 API de Analisar imprimibilidade: Analise uma tarefa Meshy bem-sucedida — ou qualquer URL de modelo 3D — quanto à prontidão para impressão 3D FDM. Padrão assíncrono de criação + stream: o POST devolve um task_id e, em seguida, o GET / stream SSE devolvem métricas de estanquidade (watertightness), volume, orifícios e arestas non-manifold assim que o estado for SUCCEEDED. Gratuito, não consome 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 de topology. Aceita um input_task_id de uma tarefa 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 automaticamente reembolsados 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 com textura diretamente (através de um URL ou de um Data URI) em vez de um input_task_id de uma tarefa Meshy anterior. Formatos suportados: .glb, .fbx. Quando são fornecidos tanto o model_url como o 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. Referencie diretamente o resultado de uma tarefa de Texto para imagem ou Imagem para imagem já concluída, 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 predefinidos inline, badges 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

  • Descontinuámos 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 o auto_size está ativado, o serviço utiliza visão por IA para estimar a altura real e redimensionar o modelo automaticamente. O origin_at define a posição da origem (bottom ou center). Na API de Remesh, o auto_size é mutuamente exclusivo com o resize_height.

17 mar

Fevereiro de 2026

28 fev

Feb 25

  • Adicionado o parâmetro image_enhancement às APIs Imagem para 3D e Multi-imagem para 3D para os utilizadores que pretendam optar por não otimizar a imagem de entrada e preservar o aspeto exato da mesma. Apenas suportado para meshy-6 e latest. O valor predefinido é true.

Feb 20

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

Janeiro 2026

Jan 27

  • Foi 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 erros da API.

Jan 26

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

Jan 22

  • Tornado obsoleto o art_style para a API Pré-visualização de Texto para 3D (Meshy-6). O parâmetro foi concebido para modelos legados (Meshy-4 / Meshy-5) e será removido numa versão futura.
  • Tornado 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 por defeito do parâmetro should_remesh para o Meshy-6 nas APIs Texto para 3D e Imagem para 3D. O parâmetro passa agora a assumir por defeito false para meshy-6, e true para outros 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 para polígonos mais limpos.

Dezembro de 2025

Dec 31

  • Lançado o API Playground, um espaço dedicado para os programadores explorarem parâmetros de API e testarem pedidos diretamente no website da Meshy.
  • Introduzidas a API de Texto para Imagem e a API de Imagem para Imagem, permitindo a geração de imagens com IA a partir de prompts 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

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

Nov 06

  • A API de Refinamento de Texto para 3D agora suporta ai_model = latest, que corresponde ao Meshy 6 Preview.
  • A API de Imagem para 3D agora utiliza por predefiniçã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 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 agora usa-a por predefinição quando omitida.

Nov 04

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

Outubro de 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 à Remesh API para suportar a conversão do formato do ficheiro do modelo de entrada apenas.
  • Adicionado rigged_character_glb_url à resposta do The Rigging Task Object.

Oct 01

  • Remoção das APIs text-to-voxel

Setembro de 2025

Sep 23

  • Adicionada a opção latest para ai_model na API Texto para 3D para utilizar 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 Image to 3D para usar o Meshy 6 Preview.

Sep 4

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

Agosto de 2025

Aug 18

Aug 13

July 2025

Jul 31

Junho de 2025

Jun 25

  • Adicionada a API de Retexturizar, que permite aos utilizadores 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.

Jun 10

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

May 2025

May 20

15 de maio

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

abril de 2025

29 de abril

  • Foi introduzida a API 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 do modelo de IA meshy-5 às APIs Texto para 3D e Imagem para 3D. A etiqueta latest passa agora também a corresponder a meshy-5.

17 abr

  • 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

28 mar

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

Mar 14

Mar 06

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

Feb 13

Feb 6

  • Adicionado o parâmetro texture_prompt às APIs Imagem para 3D e Text to 3D Refine, permitindo aos utilizadores guiar o processo de geração de textura com um prompt de texto.

Janeiro 2025

Jan 23

Jan 14

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

Jan 07

December 2024

Dec 19

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

Dec 12

  • Obsoleto a propriedade model_url em todos os objetos de resposta.
  • Separada a API Legacy do Meshy-3 da mais recente API Meshy-4.

Dec 10

Dec 5

Dec 3

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

November 2024

Nov 14