Preciso de uma chave de API Meshy?

Não. As skills iniciam sessão através do seu browser com um código de utilização única, e o Meshy CLI guarda a sessão. Se MESHY_API_KEY já estiver definida no seu ambiente, o Meshy CLI utiliza-a em vez disso.

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

Sim. A meshy-3d-printing instala-se e funciona por si própria, incluindo os passos de geração que uma impressão necessita.

Funciona quando o Hermes é executado num servidor remoto?

Sim. O início de sessão mostra um link e um código que pode aprovar a partir de qualquer browser.

Estas são as mesmas skills do plugin Codex?

Sim. O plugin Codex, o Claude Code, o Cursor e o Hermes Agent utilizam todos 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 requer um plano Meshy pago e gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita.

Skills Meshy para o Hermes Agent

Adicione as skills Meshy ao Hermes Agent para que o 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 com IA, remesh até um orçamento de polígonos, unwrapping 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 reparação de imprimibilidade, 3MF de cor única e multicor, dimensionamento para medidas reais, produtos do Creative Lab como figuras, candeeiros, porta-chaves e ímanes de frigorífico, e transferência para um software de corte instalado.

Cada skill instala-se por si própria, pelo que pode adicionar apenas a skill de impressão se for isso que precisa. Ambas as skills executam o Meshy CLI, que é o pacote meshy-cli no npm. Inicia sessão uma vez no seu browser, 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

Precisa do Hermes Agent.
Precisa do Node.js 22.12 ou posterior, com npm, no computador que executa o Hermes.
Para gerar modelos, precisa de um plano Meshy pago. Cada tarefa de geração gasta créditos Meshy às taxas da API. Para o custo de cada tarefa, consulte Preços. A análise de imprimibilidade é gratuita, e os passos de impressão locais, como redimensionar um modelo ou abri-lo num software de corte, não precisam de início de sessão.

Instalar as skills

Para deixar o Hermes fazer a configuração, cole o seguinte texto num 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 o Meshy CLI e ambas as skills, e depois guia-o pelo processo de início de sessão.

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

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

Não precisa de um npm install -g meshy-cli global. Sem isso, as skills executam o CLI através do npm exec. Uma instalação global apenas torna o arranque mais rápido.

Se o Hermes não utilizar as skills numa conversa que estava aberta enquanto as instalava, inicie uma nova sessão.

Da primeira vez que pedir um modelo, o Hermes inicia o processo de início de sessão do Meshy CLI e envia-lhe um link e um código de utilização única.

Para iniciar sessão, siga estes passos:

Abra o link em qualquer dispositivo.
Se a página pedir um código, introduza o código em Device code exatamente como o Hermes o mostra, e depois clique em Continue.
Se a Meshy lhe pedir para iniciar sessão, inicie sessão na sua conta Meshy.
Na página Connect Meshy CLI, clique em Connect. A página mostra Meshy CLI authorized.
Volte ao chat. O Hermes dá continuidade ao pedido que fez.

O código expira após 10 minutos. Se expirar, peça ao Hermes um novo. Pode aprovar o início de sessão a partir de qualquer browser, pelo que também funciona quando o Hermes é executado num servidor ou através de SSH.

O Meshy CLI guarda a sessão em ~/.config/meshy/credentials.json. Todos os agentes que são executados como o mesmo utilizador nesse computador partilham a sessão. Se MESHY_API_KEY estiver definida, o CLI utiliza essa chave de API em vez da sessão do browser.

Exemplos de prompts

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

Cria um modelo 3D de um husky bebé e guarda-o como GLB em ./assets.
Transforma esta foto num modelo 3D texturizado e mantém as suas proporções. (anexe a imagem)
Cria três garrafas de poção low-poly para o meu jogo, cada uma com menos de 1500 triângulos.
Faz o rig deste personagem humanoide, adiciona uma animação de caminhada e exporta-o como FBX.
Ajuda-me a imprimir em 3D uma pequena figura de dragão, com 80 mm de altura, como um 3MF multicor.

Os pedidos de seguimento reutilizam o resultado anterior, por exemplo faz um LOD de 1500 faces, agora como FBX, ou ajusta a escala para 150 mm. Para aprovar cada passo pago você mesmo, acrescente pergunta-me antes de gastar créditos ao seu pedido.

Resolução de problemas

A tabela seguinte lista problemas comuns, as suas causas e como resolvê-los.

Problema	Causa	Solução
O Hermes não utiliza as skills Meshy	O Hermes não carregou as skills na conversa aberta, ou não associou o seu pedido a elas.	Inicie uma nova sessão, ou mencione a Meshy no seu pedido.
`node` ou `npm` não é encontrado	O Node.js não está instalado, ou o Hermes não o consegue encontrar.	Instale o Node.js 22.12 ou posterior a partir do website do Node.js, e depois reinicie o Hermes.
O Hermes pede uma chave de API	As skills não precisam de uma. Iniciam sessão através do seu browser.	Recuse, e peça ao Hermes para iniciar sessão através do browser. Nunca cole uma chave de API num chat.
O código de início de sessão expirou	Um código é válido durante 10 minutos.	Peça ao Hermes para iniciar o processo de início de sessão novamente.
O Hermes não consegue gerar devido ao seu plano ou créditos	A geração requer um plano pago e créditos suficientes.	Verifique o seu plano e saldo na página Subscription na aplicação web Meshy.
Tem sessão iniciada na conta Meshy errada	O Meshy CLI reutiliza a sessão que guardou no seu computador.	Peça ao Hermes para executar `meshy auth logout`, e depois inicie sessão 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. Também precisa do Node.js 22.12 ou posterior com npm.
Preciso de uma chave de API Meshy?: Não. As skills iniciam sessão através do seu browser com um código de utilização única, e o Meshy CLI guarda a sessão. Se MESHY_API_KEY já estiver definida no seu ambiente, o Meshy CLI utiliza-a em vez disso.
Posso instalar apenas a skill de impressão 3D?: Sim. A meshy-3d-printing instala-se e funciona por si própria, incluindo os passos de geração que uma impressão necessita.
Funciona quando o Hermes é executado num servidor remoto?: Sim. O início de sessão mostra um link e um código que pode aprovar a partir de qualquer browser.
Estas são as mesmas skills do plugin Codex?: Sim. O plugin Codex, o Claude Code, o Cursor e o Hermes Agent utilizam todos 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 requer um plano Meshy pago e gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita.

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