Plugin Meshy para Codex

O plugin oficial do Meshy para o Codex transforma uma conversa em assets 3D. Descreva um modelo ou anexe uma foto, e o Codex o gera, texturiza e salva o arquivo no seu projeto.


Overview

O Meshy agora está disponível no Diretório de Plugins do ChatGPT (Codex), com duas habilidades:

  • Meshy 3D Generation: texto para 3D, imagem para 3D e multivista para 3D, texturização e retexturização com IA, remesh para um orçamento de polígonos, desdobramento de UV, auto-rigging 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 de cor única e multicolorido, dimensionamento para medidas do mundo real, produtos do Creative Lab (bonecos, luminárias, chaveiros, ímãs de geladeira) e transferência para um fatiador instalado.

Ambas as habilidades utilizam o Meshy CLI no seu computador. Você faz login uma única vez no navegador e nunca cola uma chave de API na conversa. Os arquivos são salvos na pasta que você indicar, com uma pré-visualização renderizada e os IDs de tarefa que o Codex precisa para edições de acompanhamento.


Requirements

  • Codex, no aplicativo desktop do ChatGPT ou no Codex CLI. Os plugins não carregam na conversa do ChatGPT em um navegador. Espaços de trabalho corporativos ou escolares podem exigir que um administrador permita plugins.
  • Node.js 22.12 ou mais recente, com npm. Verifique com node --version; se estiver ausente ou desatualizado, instale a versão LTS atual em nodejs.org.
  • Um plano Meshy pago para geração. Toda tarefa de geração gasta créditos do Meshy. Etapas locais de impressão, como redimensionar um modelo ou abri-lo em um fatiador, não exigem login.

Installation

No aplicativo desktop do ChatGPT:

  1. Mude para Codex e abra Plugins.
  2. Pesquise por Meshy e clique em Install plugin.
  3. Inicie uma nova conversa. Os plugins só carregam em conversas abertas após a instalação.

Meshy no Diretório de Plugins do Codex

No Codex CLI: execute /plugins, instale o Meshy, depois inicie uma nova sessão.

Para confirmar a instalação, digite @ em uma nova conversa e procure por Meshy, ou pergunte ao Codex quais habilidades do Meshy estão disponíveis.


Sign In

Na primeira vez que você solicitar um modelo, o plugin verifica a existência do Meshy CLI e de uma sessão ativa. Se não houver nenhuma, o Codex mostra um link de login do Meshy e um código temporário:

  1. Abra o link e faça login no Meshy.
  2. Digite o código exatamente como mostrado e clique em Connect.
  3. Retorne ao Codex. Ele continuará a solicitação que você fez.

Página de conexão do Meshy CLI

O código expira após 10 minutos; peça ao Codex um novo código caso isso aconteça. O Meshy CLI armazena a sessão no seu computador e a reutiliza em conversas futuras. Se MESHY_API_KEY estiver definida no seu ambiente, ela terá prioridade sobre a sessão do navegador.


Example Prompts

Mencione @Meshy, ou simplesmente descreva a tarefa:

  • Crie um baú do tesouro low-poly para o meu jogo, com meta de 2.000 triângulos, adicione texturas PBR e salve como GLB em ./assets.
  • Transforme esta foto em um modelo 3D texturizado e mantenha suas proporções. (anexe a imagem)
  • Faça o rig deste personagem humanoide texturizado, adicione uma animação de caminhada e exporte como FBX.
  • Retexturize ./assets/chest.glb como bronze envelhecido e salve ao lado do original.
  • Transforme esta foto em um boneco de 75 mm, verifique sua imprimibilidade e prepare um 3MF multicolorido para um fatiador compatível.

As continuações reutilizam o resultado anterior: faça um LOD de 1.500 faces, agora como FBX, redimensione para 150 mm. Quando você não indicar uma pasta, os arquivos vão para ./meshy_output.


Credits

Geração, texturização, remesh, rigging, animação e reparo gastam créditos da sua conta Meshy de acordo com as tarifas da API. A análise de imprimibilidade é gratuita. O Codex estima o custo antes das etapas pagas e pede confirmação antes de gastar além do que você aprovou. Adicione pergunte antes de gastar créditos a uma solicitação para aprovar cada etapa paga, ou pergunte quantos créditos Meshy eu tenho? a qualquer momento.


Troubleshooting

SintomaSolução
O Meshy não aparece após digitar @Use o aplicativo desktop do ChatGPT ou o Codex CLI, não a conversa no navegador. Reinicie o Codex e abra uma nova conversa.
O Codex pede uma chave de APIRecuse e peça para fazer login pelo navegador. Nunca cole uma chave de API em uma conversa.
node ou npm não encontradoInstale o Node.js 22.12 ou mais recente em nodejs.org, depois reinicie o Codex.
O código de login expirouPeça ao Codex para iniciar o login novamente. Os códigos são válidos por 10 minutos.
A geração é recusada por plano ou créditosA geração exige um plano pago e créditos suficientes. Verifique seu plano e saldo em meshy.ai.
Login feito na conta Meshy erradaPeça ao Codex para executar meshy auth logout e depois fazer login novamente.

FAQ

Is the Meshy plugin for Codex free?
The plugin is free to install. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free, and local steps such as rescaling a model or opening it in a slicer need no sign-in.
Do I need a Meshy API key?
No. The plugin signs in through your browser with a one-time code, and the Meshy CLI stores the session on your computer. Never paste an API key into a chat. If MESHY_API_KEY is already set in your environment, it is used instead of the browser session.
Where are my models saved?
In the folder you name in your request, or ./meshy_output when you don't name one, together with a preview image and the task IDs. Files are saved on your computer, not in your Meshy web workspace.
Which file formats can the plugin export?
GLB, FBX, OBJ, STL and USDZ for 3D assets, and single-color or multicolor 3MF for 3D printing.
Does the plugin work in the ChatGPT chat in a browser?
No. Plugins run in Codex, in the ChatGPT desktop app or the Codex CLI.
Can I use the same Meshy skills in Claude Code or Cursor?
Yes. The skills are open source in the meshy-3d-agent repository on GitHub and install into Claude Code, Cursor, Gemini CLI and other agents. Ask your agent to follow https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md.