Plugin Meshy para Codex

Instale o plugin Meshy no Codex para gerar e texturizar modelos 3D a partir de um chat, e guarde os ficheiros no seu projeto.


Visão geral

O plugin Meshy encontra-se no diretório de plugins partilhado pelo ChatGPT e pelo Codex, e funciona no Work e no Codex, mas não no Chat. Para criar modelos num chat do ChatGPT, para trabalhar com os modelos que criou no site da Meshy, ou para dispensar a instalação, utilize Meshy 3D, o outro plugin da Meshy no mesmo diretório. Para comparar os dois, consulte Qual plugin Meshy utilizar.

O plugin Meshy tem duas competências:

  • Meshy 3D Generation: Texto para 3D, Imagem para 3D e Multi-imagem para 3D, texturização e retexturização com IA, remesh para um orçamento de polígonos, desdobramento 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 Creative Lab como figuras, candeeiros, porta-chaves e ímanes de frigorífico, e transferência para um software de corte instalado.

Ambas as competências executam o CLI da Meshy no seu computador. O CLI é o pacote meshy-cli no npm. Inicia sessão uma vez no seu navegador, e nunca cola uma chave de API no chat.

O plugin guarda os ficheiros na pasta que indicar, com uma pré-visualização renderizada e os IDs de tarefa de que o Codex necessita para edições subsequentes. As competências são de código aberto no repositório meshy-3d-agent no GitHub.


Antes de começar

  • Precisa do Codex, na aplicação de ambiente de trabalho do ChatGPT ou no Codex CLI. O plugin Meshy não funciona no ChatGPT num navegador web. Num espaço de trabalho profissional ou escolar, pode ser necessário que um administrador autorize plugins.

  • Precisa do Node.js 22.12 ou posterior, com npm. Para verificar a sua versão, execute node --version. Se o Node.js estiver em falta ou for mais antigo, instale a versão LTS atual a partir do site do Node.js.

  • Para gerar modelos, precisa de um plano Meshy pago. Cada tarefa de geração gasta créditos Meshy. Os passos de impressão locais, como redimensionar um modelo ou abri-lo num software de corte, não requerem início de sessão.


Instalar o plugin

Para instalar o plugin na aplicação de ambiente de trabalho do ChatGPT, siga estes passos:

  1. Na aplicação de ambiente de trabalho do ChatGPT, mude para Codex.

  2. Abra Plugins.

  3. Procure por Meshy e, em seguida, abra o plugin Meshy.

  4. Clique em Install plugin.

    Página do plugin Meshy no diretório de plugins do Codex com o botão Install plugin e três exemplos de prompts

  5. Inicie um novo chat. O Codex só carrega plugins em chats que abrir depois da instalação.

Para instalar o plugin no Codex CLI, siga estes passos:

  1. Execute /plugins.

  2. Instale Meshy.

  3. Inicie uma nova sessão.

Para confirmar a instalação, escreva @ num novo chat e procure por Meshy, ou pergunte ao Codex quais as competências Meshy disponíveis.

Para um tutorial passo a passo, consulte How to Use Meshy Plugin in Codex.


Iniciar sessão

Na primeira vez que pedir um modelo, o plugin verifica se existe o CLI da Meshy e uma sessão Meshy guardada. Se não encontrar nenhuma sessão, o Codex mostra uma ligação de início de sessão da Meshy e um código temporário.

Para iniciar sessão, siga estes passos:

  1. Abra a ligação.

  2. Se a página pedir um código, introduza o código em Device code exatamente como o Codex o apresenta, e clique em Continue.

  3. Se a Meshy lhe pedir para iniciar sessão, inicie sessão na sua conta Meshy.

  4. Na página Connect Meshy CLI, clique em Connect. A página mostra Meshy CLI authorized.

    Página Connect Meshy CLI com a conta com sessão iniciada, o acesso que o CLI obtém, e os botões Cancel e Connect

  5. Regresse ao Codex. O Codex continua o pedido que fez.

O código expira ao fim de 10 minutos. Se expirar, peça ao Codex um novo. O CLI da Meshy guarda a sessão no seu computador e reutiliza-a em chats posteriores. Se MESHY_API_KEY estiver definido no seu ambiente, o CLI utiliza essa chave de API em vez da sessão do navegador.

No Codex CLI, a primeira execução pode pedir acesso à rede. Aprove-o para que o CLI da Meshy possa aceder à API da Meshy.


Exemplos de prompts

Mencione @Meshy, ou descreva a tarefa por suas próprias palavras. Por exemplo:

  • Create a low-poly treasure chest for my game, target 2,000 triangles, add PBR textures, and save it as GLB in ./assets.
  • Turn this photo into a textured 3D model and keep its proportions. (anexe a imagem)
  • Rig this textured humanoid character, add a walking animation, and export it as FBX.
  • Retexture ./assets/chest.glb as weathered bronze and save it beside the original.
  • Turn this photo into a 75 mm figurine, check its printability, and prepare a multicolor 3MF for a compatible slicer.

Os pedidos de seguimento reutilizam o resultado anterior, por exemplo make a 1,500-face LOD, now as FBX, ou scale it to 150 mm. Se não indicar uma pasta, o plugin guarda os ficheiros em ./meshy_output.


Créditos

A geração, texturização, remesh, rigging, animação e reparação gastam créditos da sua conta Meshy às taxas da API. A análise de imprimibilidade é gratuita. Para o custo de cada tarefa, consulte Preços.

Antes de um passo pago, o Codex estima o seu custo, e pergunta antes de gastar mais do que aprovou. Para aprovar cada passo pago pessoalmente, acrescente ask me before spending credits ao seu pedido. Para verificar o seu saldo a qualquer momento, pergunte how many Meshy credits do I have?


Resolução de problemas

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

ProblemaCausaSolução
A Meshy não aparece depois de escrever @Está no ChatGPT num navegador web, ou o chat já estava aberto antes de instalar o plugin.Utilize a aplicação de ambiente de trabalho do ChatGPT ou o Codex CLI. Reinicie o Codex e abra um novo chat.
O Codex pede uma chave de APIO plugin não precisa de uma. Inicia sessão através do seu navegador.Recuse, e peça ao Codex para iniciar sessão através do navegador em vez disso. Nunca cole uma chave de API num chat.
node ou npm não é encontradoO Node.js não está instalado, ou o Codex não consegue encontrá-lo.Instale o Node.js 22.12 ou posterior a partir do site do Node.js, e reinicie o Codex.
O código de início de sessão expirouUm código é válido durante 10 minutos.Peça ao Codex para iniciar o processo de início de sessão novamente.
O Codex não consegue gerar devido ao seu plano ou créditosA geração requer um plano pago e créditos suficientes.Verifique o seu plano e saldo na página Subscription na aplicação web da Meshy.
Tem sessão iniciada na conta Meshy erradaO CLI da Meshy reutiliza a sessão que guardou no seu computador.Peça ao Codex para executar meshy auth logout, e depois inicie sessão novamente.

Perguntas frequentes

O plugin Meshy para Codex é gratuito?
O plugin é gratuito para instalar. Gerar modelos 3D requer um plano Meshy pago e gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita, e os passos locais, como redimensionar um modelo ou abri-lo num software de corte, não requerem início de sessão.
Preciso de uma chave de API da Meshy?
Não. O plugin inicia sessão através do seu navegador com um código temporário, e o CLI da Meshy guarda a sessão no seu computador. Nunca cole uma chave de API num chat. Se MESHY_API_KEY já estiver definido no seu ambiente, o CLI da Meshy utiliza-a em vez da sessão do navegador.
Onde são guardados os meus modelos?
Na pasta que indicar no seu pedido, ou em ./meshy_output se não indicar nenhuma, juntamente com uma imagem de pré-visualização e os IDs de tarefa. O plugin guarda os ficheiros no seu computador, não na aplicação web da Meshy.
Quais os formatos de ficheiro que o plugin consegue exportar?
GLB, FBX, OBJ, STL e USDZ para ativos 3D, e 3MF de cor única ou multicor para impressão 3D.
O plugin funciona no ChatGPT num navegador web?
Não. O plugin Meshy funciona no Work e no Codex, na aplicação de ambiente de trabalho do ChatGPT ou no Codex CLI.
O plugin consegue ver os modelos que criei no site da Meshy?
Não. O plugin Meshy funciona apenas com tarefas que foram criadas através da API da Meshy, como as que ele próprio criou. Para ver e transferir os modelos na sua conta Meshy, incluindo os do site da Meshy, utilize o Meshy 3D.
Posso utilizar as mesmas competências Meshy no Claude Code ou no Cursor?
Sim. As competências são de código aberto no repositório meshy-3d-agent no GitHub, e pode instalá-las no Claude Code, Cursor, Gemini CLI e noutros agentes. Peça ao seu agente para seguir https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md.