lowpoly será descontinuado a 30/10/2026. Mude de modelo antes destas datas para evitar erros nos pedidos. Ver todas as descontinuações

Registo de alterações

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

Prefere um feed em direto? As entradas mais recentes também aparecem na página de visão geral da Developer Platform.

Novembro de 2026

Nov 3

  • Adicionado texture_model a Imagem para 3D e Multi-imagem para 3D, para que selecione o modelo de textura na mesma tarefa que a malha. Imagem para 3D aceita Meshy 7 (meshy-7), Meshy N1 (meshy-n1) e Meshy 6 Lite (meshy-6-lite) com qualquer ai_model. Multi-imagem para 3D aceita os modelos de textura multivista, Meshy 7 e Meshy N1. Cada modelo de textura mantém os seus próprios limites; consulte Models. Uma tarefa custa o preço apenas da malha do seu ai_model mais o preço do Retexturizar na respetiva resolução de textura; consulte Preços. Os pedidos sem texture_model funcionam como antes.
  • Adicionado ai_model: "meshy-n1" ao refine de Texto para 3D. Sem texture_image_url, o Meshy N1 texturiza a partir da imagem de referência que uma pré-visualização Meshy 7.1 ou latest armazena. Outras pré-visualizações precisam de texture_image_url. Um refine com Meshy N1 custa 10 créditos.

Nov 2

  • Adicionado ai_model: "meshy-n1" à API Retexturizar. O Meshy N1 cria uma textura de cor base em 2K a partir de uma a quatro imagens de referência. Com mais de uma imagem, a primeira é a vista frontal e a ordem das restantes não importa, tal como acontece com o Meshy 7. Não aceita prompt de texto, não cria mapas PBR nem texturas em 4K e 8K, e texturiza modelos 3D com até 7 999 999 faces. Uma tarefa custa 10 créditos, o mesmo que uma Retexturização em 2K; ver Preços. latest continua a corresponder ao Meshy 7.

Outubro de 2026

Oct 30

  • Alguns pedidos do Meshy T1 (model_type: "lowpoly" ou ai_model: "meshy-t1") em Texto para 3D e Imagem para 3D são agora executados com o Smart Topology, e os restantes devolvem 400. model_type: "smart-topology" com ai_model: "meshy-t2.5" substitui o T1. A partir de 30 de novembro de 2026, todos os pedidos T1 devolvem 400. A página Deprecations indica quais os pedidos que ainda são executados.
  • A Auto Split API tem um novo parâmetro opcional, keep_texture. Com keep_texture: true, cada parte de um modelo texturizado mantém a textura, e a tarefa devolve os mapas de textura em texture_urls, além de um ficheiro mtl com um OBJ. Sem este parâmetro, a divisão funciona como anteriormente. Uma divisão que mantém a textura demora cerca do dobro do tempo e continua a custar 10 créditos. input_task_id também aceita tarefas de refine de Texto para 3D e de Retexturizar.

Oct 26

  • Nova página de Obsolescências: o ciclo de vida de cada modelo de geração 3D (ativo, legacy, obsoleto ou retirado) com a respetiva data de retirada e substituição recomendada, o histórico de cada obsolescência da API, e os parâmetros obsoletos ainda em funcionamento. O banner de retirada nas páginas da API agora tem uma ligação para ela.

Oct 23

  • texture_image_url tornado obsoleto em Rigging. A Meshy utiliza as texturas incorporadas no ficheiro model_url, ou as texturas da tarefa de entrada, pelo que deve omiti-lo quando o modelo já tem as suas próprias texturas. Se o enviar, a imagem torna-se a única textura do modelo com rig, e o modelo perde os seus mapas PBR.

Oct 21

  • Adicionado o cabeçalho X-Meshy-Metadata para equipas Studio e Enterprise em todos os endpoints que criam uma tarefa, exceto os endpoints do Creative Lab. Marque uma tarefa com os seus próprios pares chave-valor, como user=alex@example.com,team=fab, e consulte-os posteriormente no campo metadata dos registos de Usage. Consulte Metadata.

Oct 19

  • export_resolution agora aceita valores até 512, em vez do anterior 2048, nas tarefas de criação do Keychain e do Fridge Magnet. 512 é a resolução do mapa de profundidade a partir do qual a geometria é construída, pelo que qualquer valor acima deste apenas colocava vértices extra entre amostras já existentes, resultando num ficheiro maior que descreve a mesma superfície. 512 é também o valor predefinido, pelo que quem nunca definir export_resolution não é afetado. Um valor acima de 512 passa agora a devolver 400 no momento da criação, em vez de ser aceite. 2048 em particular ultrapassava sempre o limite de tempo do gerador e falhava depois de a tarefa ter sido iniciada. Se definir export_resolution acima de 512, remova o parâmetro ou defina-o como 512.

Oct 15

  • Adicionado ai_model: "meshy-t2.5" às APIs Imagem para 3D e Texto para 3D: o modelo Smart Topology mais recente, com detalhe mais nítido para assets de jogos. Utilize-o com model_type: "smart-topology"; o resultado é apenas de triângulos, e target_polycount aceita valores entre 100 e 30 000 (predefinição 15 000). O preço é igual ao de meshy-t2; consulte Preços. Este modelo é agora o predefinido quando model_type: "smart-topology" é definido sem ai_model; defina ai_model: "meshy-t2" para continuar a utilizar o Meshy T2. A Multi-imagem para 3D não suporta meshy-t2.5.

Oct 14

  • O model_url agora aceita ficheiros até 400 MB, em vez dos 100 MB anteriores, quando se trata de um URL http ou https, em Retexturizar, Remesh, Rigging, Converter, Redimensionar, Desdobramento UV, Impressão Multicor, Analisar imprimibilidade, e Reparar imprimibilidade. Um URI data: mantém-se nos 100 MB. Um ficheiro GLB, glTF, FBX ou OBJ com mais de 100 MB pode ter no máximo 10 000 000 faces (8 000 000 no caso da Impressão Multicor), contadas como triângulos; um ficheiro com mais faces do que isso devolve 400. Acima de 100 MB, um ficheiro FBX tem de ser FBX binário 7.1 ou mais recente, e um ficheiro GLB ou glTF não pode usar compressão Draco. O ficheiro é descarregado antes de o pedido de criação devolver resposta, pelo que deve prever até 120 segundos para um ficheiro grande (ver Ciclo de Vida da Tarefa). Ficheiros com 100 MB ou menos comportam-se como antes, e os preços mantêm-se inalterados.
  • Analisar imprimibilidade agora responde a um input_task_id pertencente a outra conta com 404 e o mesmo corpo de resposta que um id inexistente, em vez de 403. Uma tarefa sua, ou de um colega de equipa num espaço de trabalho a que pertence, continua a funcionar como antes.

12 de out.

  • Os ficheiros USDZ passam agora a usar metros, pelo que os modelos abrem com o seu tamanho real no AR Quick Look, Reality Composer, Blender e outros visualizadores USD. O ficheiro usdz em model_urls das tarefas de Texto para 3D, Imagem para 3D, Multi-imagem para 3D, Retexturizar, Remesh, Converter, Redimensionar e Auto Split passa agora a declarar metersPerUnit = 1. Até agora declarava pés (metersPerUnit = 0.3048) enquanto as suas coordenadas estavam em metros, pelo que o modelo era apresentado a 30,48% do seu tamanho. Se dimensionar ficheiros USDZ por 3,28 para compensar, remova esse dimensionamento nas tarefas criadas a partir desta data. Os ficheiros de tarefas anteriores mantêm a sua unidade atual, e os ficheiros USDZ de Rigging e Animação não são afetados.

Oct 10

  • O meshy-5 foi descontinuado. Os pedidos que enviem ai_model: "meshy-5" para Text to 3D, Image to 3D, Multi-Image to 3D ou Retexture passam agora a devolver 400 com a mensagem ai_model meshy-5 has been retired; use meshy-6-lite. Mude para meshy-6-lite, que aceita os mesmos parâmetros com o mesmo custo em créditos. Os modelos que já tenha gerado com meshy-5 continuam disponíveis, e o refine de uma preview do meshy-5 sem definir ai_model continua a funcionar.
  • O formato .webp está agora documentado como formato de imagem de entrada suportado, juntamente com .jpg, .jpeg e .png, em Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) e Text to 3D Refine (texture_image_url). Funciona tanto para URLs públicos como para data URIs (data:image/webp;base64,...). As integrações existentes não são afetadas e os preços mantêm-se inalterados.
  • Get Balance passa agora também a devolver monthly_credits, permanent_credits e monthly_resets_at, para que possa ver quanto do seu saldo expira na próxima renovação. O próprio balance mantém-se inalterado.

Oct 6

  • As funcionalidades Analisar imprimibilidade e Reparar imprimibilidade podem agora verificar a espessura de parede no tamanho que planeia imprimir. Envie printer_type, um tamanho de impressão, ou ambos. A análise reporta paredes finas em printability.thin_walls, e a reparação torna-as mais espessas quando necessário, podendo reutilizar a impressora e o tamanho de uma tarefa de análise passada como input_task_id. As integrações que não utilizam estes campos comportam-se como antes, e os preços mantêm-se inalterados.

Setembro de 2026

Sep 29

  • O caminho legado /v2/text-to-3d (sem o prefixo /openapi) está obsoleto. Continua a funcionar sem alterações por agora, mas será removido numa versão futura. Mude para /openapi/v2/text-to-3d, que recebe o mesmo pedido e devolve a mesma resposta. As respostas no caminho legado passam agora a incluir um cabeçalho Deprecation e um cabeçalho Link a apontar para o novo caminho.

Sep 28

  • As respostas da API incluem agora cabeçalhos de limite de taxa, incluindo Retry-After para indicar quanto tempo deve esperar antes de tentar novamente ou de fazer nova consulta.
  • O Multi-Color Print aceita agora um novo parâmetro printer_brand que escreve uma predefinição de software de corte correspondente no 3MF, para que o ficheiro abra pronto a imprimir em impressoras Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker e AnkerMake, bem como Bambu Lab (a predefinição). A página documenta agora também max_depth.

Sep 18

  • Adicionado meshy-7.1 como valor de ai_model para Imagem para 3D, Multi-imagem para 3D, e Texto para 3D: mesmos parâmetros e custo em créditos que meshy-7, com maior detalhe de geometria. latest passa agora a resolver para meshy-7.1; meshy-7 está obsoleto mas continua a funcionar sem alterações.
  • Adicionado geometry_resolution (standard / 2k / 4k) às mesmas APIs, substituindo o agora obsoleto ultra_mode (ultra_mode: true continua a funcionar e equivale a "2k"). 4k requer Meshy 7.1 (meshy-7.1 ou latest), não está disponível em Multi-imagem para 3D, e custa os mesmos 5 créditos extra que 2k.

16 de set.

  • A API Auto Split agora aceita um input_task_id com textura. Anteriormente rejeitava-o com 400, o que significava gerar a mesma malha uma segunda vez com should_texture: false para a dividir. Uma divisão corta a geometria e reconstrói as superfícies de cada parte, pelo que a textura do input não é transferida e o resultado é um modelo sem textura, com uma cor lisa por parte. Isto já era verdade para todas as divisões e mantém-se inalterado.
  • O meshy-5 será retirado a 10 de outubro de 2026. Deixou de estar documentado como valor de ai_model para Texto para 3D, Imagem para 3D, Multi-imagem para 3D ou Retexturizar, e após 10 de outubro os pedidos que enviem ai_model: "meshy-5" devolverão um erro.
  • A chave de API partilhada do modo de teste foi retirada; os pedidos que ainda a enviem devolvem agora 401 Unauthorized. Se a copiou para código ou para o CI, substitua-a pela sua própria chave na página de Chaves de API. Essa chave devolvia sempre o mesmo modelo de exemplo, independentemente do input, pelo que nunca mostrava o que um pedido geraria de facto. Para ver o que a API devolve antes de desenvolver com base nela, utilize o Playground na Plataforma de Desenvolvimento, que executa uma tarefa real no seu navegador. Em planos sem acesso à API, este executa o Imagem para 3D sem chave de API e utiliza os créditos da sua conta tal como qualquer outra tarefa.

Sep 15

  • Adicionados os valores gpt-image-2-5-flare e gpt-image-2-5-sunburst aos valores documentados de ai_model para as APIs Texto para imagem e Imagem para imagem. Estes são níveis do OpenAI GPT Image 2.5, com o mesmo preço do gpt-image-2 (Texto para imagem: 9 créditos; Imagem para imagem: 12 créditos).
  • Os modelos GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) passam agora também a aceitar as proporções 4:3 e 3:4 nas APIs Texto para imagem e Imagem para imagem, além de 1:1, 16:9, 9:16, 3:2 e 2:3.

Sep 14

  • A API de Imagem para imagem agora aceita input_task_id, pelo que pode encadear diretamente a partir de uma tarefa de Texto para imagem ou Imagem para imagem concluída, em vez de copiar os seus URLs de saída para reference_image_urls.

Sep 11

  • Alteração de comportamento: DELETE numa tarefa que já está IN_PROGRESS é agora rejeitado com 409 Conflict, e a tarefa fica a decorrer. Anteriormente, retornava 200 OK, parava o worker e descartava o resultado, mas mantinha os créditos, uma vez que apenas as tarefas PENDING são reembolsáveis. A chamada custava-lhe simultaneamente o modelo e os créditos, sem nada na resposta que o indicasse. Se a sua integração elimina tarefas para as cancelar, tenha em atenção que uma tarefa que o worker já tenha iniciado não pode ser cancelada. Aguarde por SUCCEEDED, FAILED ou CANCELED, e só depois a elimine. As tarefas PENDING continuam a ser eliminadas e reembolsadas exatamente como antes, e as tarefas em estado terminal continuam a ser eliminadas. Aplica-se a todas as famílias de tarefas sob /openapi. Consulte Erros.
  • Adicionado meshy-6-lite aos valores documentados de ai_model para as APIs de Texto para 3D, Imagem para 3D, Multi-imagem para 3D e Retexturizar. É o sucessor do meshy-5: mesmos parâmetros, mesmo custo em créditos (5 para a malha, 15 com textura, 10 para uma retexturização).
  • O meshy-5 está agora obsoleto em todas as APIs que o aceitam. Continua a funcionar e nada muda no seu pedido ou na sua fatura, mas deixará de aceitar novo tráfego numa versão futura. Se a sua integração envia ai_model: "meshy-5", migre para meshy-6-lite.

Sep 9

  • Nova API de Auto Split: divide um modelo Meshy 6 ou Meshy 7 sem textura em peças imprimíveis separadamente. A divisão é feita automaticamente, pelas peças que nomear (by_parts), ou por região de cor (by_color), com conectores de macho-fêmea opcionais e reforço de paredes finas. Exporta cada peça como um objeto próprio em glb, obj, fbx, usdz, blend, ou 3mf, montadas ou dispostas na plataforma de construção (layout). 10 créditos por tarefa.

Sep 7

  • Adicionado o parâmetro name_text à fase de protótipo da API do Creative Lab Keychain: grave um nome com até 10 caracteres no porta-chaves, a mesma personalização oferecida pela aplicação web. A fase de construção herda a gravação automaticamente, e o objeto da tarefa de protótipo agora devolve name_text para que possa confirmar o texto exato antes de construir. name continua a ser apenas um rótulo de exibição da tarefa e não é gravado.

5 de set.

  • Adicionada a API do Creative Lab Fidget Pixel: transforma uma fotografia numa placa fidget de pixel art multicolor, imprimível em 3D, em duas fases. POST /prototype (6 créditos) pixeliza a fotografia numa imagem de pixel art. Passe type como person ou other para escolher o estilo de pixelização. POST /build (30 créditos) amostra-a numa grelha 16 ou 32 e transforma cada pixel numa peça square ou hex interligável, entregue como um único ficheiro 3MF com marcação de cores para impressão com múltiplos filamentos. A geometria das peças é ajustável através de piece_size_mm, color_count e piece_height_mm.

Sep 4

  • Foi adicionado o GET /openapi/v1/animations/library à Biblioteca de animações: obtenha todas as ações predefinidas aceites pela API de Animação (action_id, nome, categoria e uma pré-visualização GIF animada) com filtros de pesquisa e de categoria, para que possa construir o seu próprio seletor de ações em vez de consultar a tabela de referência. Gratuito; não consome créditos.
  • Foi adicionada a API Creative Lab Collapsible Fidget: transforme uma fotografia num brinquedo fidget colapsável pronto a imprimir, no qual a silhueta do sujeito se torna em anéis concêntricos aninhados que colapsam na horizontal e voltam a esticar-se, impresso numa única peça sem necessidade de montagem. Um único POST conduz a imagem até ao modelo final. Não existe um par de fases de protótipo/construção nem parâmetros de geometria para ajustar. Cada tarefa custa 6 créditos e devolve um ficheiro STL pronto a imprimir, além de um GLB para pré-visualização quando a Meshy consegue gerá-lo.

Sep 3

  • A fase de protótipo da API Creative Lab Lamp agora devolve um modelo 3D. POST /prototype transforma a imagem conceptual numa GLB de abajur oco, e o objeto de tarefa do protótipo passa a incluir model_urls.glb e thumbnail_url juntamente com image_urls. A fase de build executa apenas o processador de candeeiro nesse modelo e agora produz um abajur com o fundo aberto e uma placa de base para a fonte de luz. Os Preços acompanham o trabalho. O protótipo custa 30 créditos e o build 6 créditos (anteriormente 6 e 30). O parâmetro text do protótipo foi removido, e image_url é obrigatório.

Sep 2

  • A API Animation aceita agora action_ids, pelo que pode aplicar até 10 ações predefinidas a uma personagem com rig num único pedido e receber um único ficheiro contendo um clip de animação por ação, pronto a ser utilizado a partir de uma máquina de estados num motor de jogo. Os clips mantêm a ordem em que os lista e transportam o nome da biblioteca da animação. Custa 3 créditos por ação, e post_process aplica-se ao ficheiro combinado. Consulte a Referência da Biblioteca de animações para os ids disponíveis e a tabela de preços.

Sep 1

  • Adicionado o parâmetro ultra_mode à Multi-imagem para 3D API: ativa a geração Ultra no ai_model meshy-7 (ou latest) para geometria de maior fidelidade com detalhe de superfície mais fino, por mais 5 créditos. É o mesmo processamento Ultra que a Imagem para 3D API oferece, agora disponível com entradas Multivista.
  • Removido o meshy-t1 dos valores de ai_model documentados para o model_type Smart Topology da Imagem para 3D API. O Smart Topology agora documenta apenas meshy-t2; as novas integrações devem utilizar este em vez do anterior. A descontinuação do Meshy T1 está planeada. Se a sua integração enviar atualmente ai_model: "meshy-t1", migre para meshy-t2.

Agosto 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, registos temporais, 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 efeitos de controlo de custos e sistemas financeiros.

Aug 26

  • A Animation API aceita agora motion_task_id, permitindo aplicar 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. Mesmo custo de 3 créditos por tarefa.

Aug 24

  • Alargado o suporte de aspect_ratio para o 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 por suportar para este modelo.

Aug 21

  • Adicionada a API Text to Motion: gera um clipe de movimento de uma 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 qualidade mais elevada 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 entre 2 e 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 uniformes e planas 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.

18 de agosto

  • Adicionado o parâmetro texture_image_urls à API Multi-imagem para 3D: forneça entre 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.

17 de agosto

Aug 13

  • Adicionado ai_model: "meshy-7" à API de 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 preview, que ativa a geração Ultra para um detalhe de superfície ainda mais fino por 5 créditos adicionais. Para texturizar com o Meshy 7, indique ai_model: "meshy-7" na tarefa de 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, peças separadas nativamente, saída em triângulos e uma contagem 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 para 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 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 de Multi-imagem para 3D: o modelo de geração multivista da Meshy, que condiciona todas as suas vistas de entrada em conjunto e utiliza-as para orientar a texturização.
  • Adicionado ai_model: "meshy-7" à API de 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 de 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 asset reparado no seu formato de entrada.

July 2026

Jul 27

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

Jul 22

  • Novo Creative Lab Keycap API: transforma uma fotografia numa keycap personalizada a cores para teclado mecânico. Utiliza um 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 ficheiros de saída GLB e OBJ, exportados à escala real em milímetros. Atualmente suporta a base padrão Cherry MX 1u (cherry-mx-1x1-r1); estão previstos 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 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 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 API Creative Lab Vinyl Figure: transforme uma fotografia numa figura 3D colecionável em vinil com cabeça grande. Utiliza o mesmo fluxo de trabalho de duas etapas que a API Figure. prototype (6 créditos) gera uma imagem conceptual estilizada, e build (30 créditos) transforma-a num modelo 3D texturizado com resultados em GLB e OBJ + MTL. Consulte Preços para o detalhe completo.

Jul 13

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

Jul 7

  • Adicionado o parâmetro aspect_ratio à API Imagem para imagem, para que possa 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; 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, em seguida, copiar o cURL, Python ou JavaScript equivalente. Disponível nos planos Pro, Premium, Ultra, Studio e Enterprise.

Jun 15

  • Nova API de Desdobramento UV: gera uma disposição UV de alta qualidade para um modelo 3D existente (o passo necessário antes da texturização, ou sempre que precisar de uma disposição UV limpa e sem sobreposições 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 (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 em 30 créditos. O preço de Prototype mantém-se em 6 créditos por imagem. Consulte Pricing para a lista 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 existente thumbnail_url mantém-se inalterado. O valor predefinido é false.

Jun 1

  • Novas Creative Lab APIs: uma família de endpoints específicos de produto que transformam uma foto de origem (ou um prompt de texto) num produto de consumo imprimível em 3D. Quatro produtos no lançamento: Keychain (porta-chaves), Fridge Magnet (íman de frigorífico), Figure (figura) e Lamp (candeeiro). Cada um segue um fluxo de trabalho em duas fases, prototype → build, encadeadas através de input_task_id, disponibilizado sob URLs específicos de produto (/openapi/creative-lab/<product>/v1/...) com versionamento próprio 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 Multi-imagem para 3D. Quando definido como true, a tarefa renderiza adicionalmente quatro thumbnails 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 Remesh API está agora disponível como endpoints independentes Convert API e Resize API. Os parâmetros obsoletos na Remesh continuarão a funcionar para retrocompatibilidade.

13 de maio

  • Adicionado o parâmetro multi_view_thumbnails à API de 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 existente thumbnail_url permanece inalterado. Acrescenta aproximadamente 3 segundos à latência da tarefa.

12 de maio

  • Adicionado o parâmetro resize_longest_side à API de Remesh. Redimensiona o modelo de forma que a maior dimensão da caixa delimitadora seja igual ao valor especificado em metros. Mutuamente exclusivo com resize_height e auto_size.

May 11

May 7

  • Nova API 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, volume, orifícios e arestas non-manifold quando o estado for SUCCEEDED. Gratuito, sem consumo de créditos.
  • Nova API Reparar imprimibilidade: Repare um modelo 3D para imprimibilidade FDM, corrigindo 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 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 diretamente um modelo 3D com textura (através de um URL ou Data URI) em vez de um input_task_id de uma tarefa anterior do Meshy. 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. Permite referenciar 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 distintas.

Março de 2026

Apr 2

  • Adicionado suporte ao formato 3mf ao parâmetro target_formats em todos os endpoints (Imagem para 3D, Texto para 3D, Remesh, Retexturizar). Nota: o 3MF é apenas opcional e deve ser solicitado explicitamente.
  • Nova API de Impressão Multicor: Converte 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 à API que utilizem meshy-4 deixaram de ser suportados. 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 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.

17 de março

Fevereiro de 2026

28 de fevereiro

Feb 25

  • Adicionado o parâmetro image_enhancement às APIs Imagem para 3D e Multi-imagem para 3D para utilizadores que pretendam renunciar à 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 de 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 tratar melhor os erros da API.

Jan 26

  • A API 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 Meshy 6.

Jan 22

  • Tornado obsoleto o art_style para a API de Pré-visualização Texto para 3D (Meshy-6). O parâmetro foi concebido para modelos Legacy (Meshy-4 / Meshy-5) e será removido numa versão futura.
  • Tornado obsoleto o enable_pbr para as APIs de Texto para 3D e Imagem para 3D quando o ai_model é meshy-4. Este parâmetro será removido numa versão futura.
  • Atualizado o valor predefinido do parâmetro should_remesh para Meshy-6 nas APIs de Texto para 3D e Imagem para 3D. O parâmetro agora assume por predefinição false para meshy-6, e true para os restantes modelos quando não especificado.

Jan 19

Jan 12

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

Dezembro de 2025

Dec 31

  • 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 recurso a 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 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 Refine 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 em Meshy-5.
  • A API de Retexturizar adiciona uma opção latest para ai_model (Meshy-6-preview) e passa a utilizá-la por predefinição quando omitida.

Nov 04

  • A Remesh API passa agora a preservar as texturas em modelos carregados.
  • A Retexture API passa agora a preservar as texturas em 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 à 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

  • Remover as APIs text-to-voxel

Setembro de 2025

Sep 23

  • Adicionada uma 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 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 para Remesh e Retexture.

Agosto de 2025

Aug 18

13 de ago

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

Julho de 2025

31 de jul

June 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.

Jun 10

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

May 2025

May 20

15 de maio

  • Introdução da API de Auto-rigging & Animação, que permite aos utilizadores aplicar rigging e animar modelos 3D automaticamente. Saiba mais sobre Rigging e Animação.

Abril de 2025

29 de abril

  • Introdução da 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.
  • Adicionada a opção de modelo de IA meshy-5 às APIs de Texto para 3D e Imagem para 3D. A etiqueta 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 guiar o processo de geração de textura 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.

Mar 14

Mar 06

  • Preços atualizados para as tarefas de geração da 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 de 2025

Feb 18

  • Adicionada uma chave de API do modo de teste que permite aos programadores testar a integração com a 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 Significativas:

    • A criação de tarefas no nível gratuito terminará a March 20, 2025. Depois disso, todos os pedidos de tarefas da API exigirão uma subscrição paga. Para manter o seu acesso sem interrupções, recomendamos que faça a atualização 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.

Janeiro 2025

Jan 23

Jan 14

  • Obsoleto o legado das APIs de Texto para 3D e Imagem para 3D, baseadas nos modelos de IA Meshy-3.

Jan 07

December 2024

Dec 19

  • Adicionadas as APIs de Remesh, que permitem aos utilizadores aplicar remesh e exportar modelos 3D existentes, 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 a 300 000 para utilizadores Premium.

12 de dezembro

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

10 de dezembro

Dec 5

Dec 3

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

November 2024

Nov 14