Preciso de uma chave de API da Meshy?

Não. As skills fazem login pelo navegador com um código de uso único, e a CLI da Meshy armazena a sessão. Se MESHY_API_KEY já estiver definida no seu ambiente, a CLI da Meshy a usa em vez disso.

Posso instalar apenas a skill de impressão 3D?

Sim. A meshy-3d-printing é instalada e funciona de forma independente, incluindo as etapas de geração que uma impressão precisa.

Funciona quando o Hermes roda em um servidor remoto?

Sim. O login mostra um link e um código que você pode aprovar em qualquer navegador.

Essas são as mesmas skills do plugin do Codex?

Sim. O plugin do Codex, o Claude Code, o Cursor e o Hermes Agent usam a meshy-3d-generation e a meshy-3d-printing do repositório de código aberto meshy-3d-agent.

As skills são gratuitas e de código aberto. Gerar modelos 3D exige um plano pago da Meshy e consome créditos Meshy nas taxas da API. A análise de imprimibilidade é gratuita.

Skills da Meshy para o Hermes Agent

Adicione as skills da Meshy ao Hermes Agent para que seu agente possa gerar modelos 3D, texturas e animações, e preparar impressões 3D, a partir de um chat.

Visão geral

A Meshy tem duas skills para o Hermes Agent:

meshy-3d-generation: Texto para 3D, Imagem para 3D e Multi-imagem para 3D, texturização e retexturização por IA, remesh para um orçamento de polígonos, desdobramento de UV, rigging automático e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
meshy-3d-printing: análise e reparo de imprimibilidade, 3MF em cor única e multicolorido, dimensionamento para medidas reais, produtos do Creative Lab como estatuetas, luminárias, chaveiros e ímãs de geladeira, e transferência para um fatiador instalado.

Cada skill é instalada de forma independente, então você pode adicionar apenas a skill de impressão se for só isso que precisar. Ambas as skills executam a CLI da Meshy, que é o pacote meshy-cli no npm. Você faz login uma vez no navegador e não precisa de uma chave de API.

As skills são de código aberto no repositório meshy-3d-agent no GitHub.

Antes de começar

Você precisa do Hermes Agent.
Você precisa do Node.js 22.12 ou posterior, com npm, no computador que executa o Hermes.
Para gerar modelos, você precisa de um plano pago da Meshy. Toda tarefa de geração consome créditos Meshy nas taxas da API. Para o custo de cada tarefa, consulte Preços. A análise de imprimibilidade é gratuita, e as etapas locais de impressão, como redimensionar um modelo ou abri-lo em um fatiador, não exigem login.

Instalar as skills

Para deixar o Hermes fazer a configuração, cole o seguinte texto em um chat:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

O Hermes verifica o Node.js, instala a CLI da Meshy e ambas as skills, e então te guia pelo login.

Para instalar as skills você mesmo, adicione-as a partir do GitHub com o Hermes:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

Você também pode instalar ambas as skills com o instalador skills:

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

Você não precisa de uma instalação global com npm install -g meshy-cli. Sem ela, as skills executam a CLI por meio do npm exec. Uma instalação global só torna a inicialização mais rápida.

Se o Hermes não usar as skills em uma conversa que estava aberta enquanto você as instalava, inicie uma nova sessão.

Na primeira vez que você pedir um modelo, o Hermes inicia o login da CLI da Meshy e envia a você um link e um código de uso único.

Para fazer login, siga estas etapas:

Abra o link em qualquer dispositivo.
Se a página pedir um código, digite o código em Device code exatamente como o Hermes o mostra, e então clique em Continue.
Se a Meshy pedir que você faça login, acesse sua conta Meshy.
Na página Connect Meshy CLI, clique em Connect. A página mostra Meshy CLI authorized.
Retorne ao chat. O Hermes continua a solicitação que você fez.

O código expira após 10 minutos. Se ele expirar, peça ao Hermes um novo. Você pode aprovar o login de qualquer navegador, então isso também funciona quando o Hermes é executado em um servidor ou via SSH.

A CLI da Meshy armazena a sessão em ~/.config/meshy/credentials.json. Todo agente que roda como o mesmo usuário nesse computador compartilha a sessão. Se MESHY_API_KEY estiver definida, a CLI usa essa chave de API em vez da sessão do navegador.

Exemplos de prompts

Descreva a tarefa com suas próprias palavras. Por exemplo:

Faça um modelo 3D de um filhote de husky e salve como GLB em ./assets.
Transforme esta foto em um modelo 3D texturizado e mantenha suas proporções. (anexe a imagem)
Crie três garrafas de poção low-poly para o meu jogo, cada uma com menos de 1.500 triângulos.
Faça o rigging deste personagem humanoide, adicione uma animação de caminhada e exporte como FBX.
Me ajude a imprimir em 3D uma pequena estatueta de dragão, com 80 mm de altura, como um 3MF multicolorido.

Solicitações de acompanhamento reutilizam o resultado anterior, por exemplo faça um LOD de 1.500 faces, agora como FBX, ou redimensione para 150 mm. Para aprovar você mesmo cada etapa paga, adicione me pergunte antes de gastar créditos à sua solicitação.

Solução de problemas

A tabela a seguir lista problemas comuns, suas causas e como corrigi-los.

Problema	Causa	Solução
O Hermes não usa as skills da Meshy	O Hermes não carregou as skills na conversa aberta, ou não associou sua solicitação a elas.	Inicie uma nova sessão, ou mencione a Meshy na sua solicitação.
`node` ou `npm` não é encontrado	O Node.js não está instalado, ou o Hermes não consegue encontrá-lo.	Instale o Node.js 22.12 ou posterior a partir do site do Node.js, e então reinicie o Hermes.
O Hermes pede uma chave de API	As skills não precisam de uma. Elas fazem login pelo navegador.	Recuse, e peça ao Hermes para fazer login pelo navegador em vez disso. Nunca cole uma chave de API em um chat.
O código de login expirou	Um código é válido por 10 minutos.	Peça ao Hermes para iniciar o login novamente.
O Hermes não consegue gerar por causa do seu plano ou créditos	A geração exige um plano pago e créditos suficientes.	Verifique seu plano e saldo na página Subscription no aplicativo web da Meshy.
Você está conectado à conta Meshy errada	A CLI da Meshy reutiliza a sessão armazenada no seu computador.	Peça ao Hermes para executar `meshy auth logout`, e então faça login novamente.

FAQ

Como adiciono a Meshy ao Hermes Agent?: Peça ao Hermes para seguir https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, ou execute hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation e o mesmo comando para meshy-3d-printing. Você também precisa do Node.js 22.12 ou posterior com npm.
Preciso de uma chave de API da Meshy?: Não. As skills fazem login pelo navegador com um código de uso único, e a CLI da Meshy armazena a sessão. Se MESHY_API_KEY já estiver definida no seu ambiente, a CLI da Meshy a usa em vez disso.
Posso instalar apenas a skill de impressão 3D?: Sim. A meshy-3d-printing é instalada e funciona de forma independente, incluindo as etapas de geração que uma impressão precisa.
Funciona quando o Hermes roda em um servidor remoto?: Sim. O login mostra um link e um código que você pode aprovar em qualquer navegador.
Essas são as mesmas skills do plugin do Codex?: Sim. O plugin do Codex, o Claude Code, o Cursor e o Hermes Agent usam a meshy-3d-generation e a meshy-3d-printing do repositório de código aberto meshy-3d-agent.
É gratuito?: As skills são gratuitas e de código aberto. Gerar modelos 3D exige um plano pago da Meshy e consome créditos Meshy nas taxas da API. A análise de imprimibilidade é gratuita.

Para usar as mesmas skills no Codex, consulte Plugin da Meshy para o Codex.
Para usar as mesmas skills no OpenClaw, consulte Skill da Meshy para o OpenClaw.
Para chamar a API da Meshy a partir de um agente de IA com sua própria chave de API, consulte Integração de IA.