Plugin Meshy para Codex

O plugin oficial Meshy para Codex transforma uma conversa em assets 3D. Descreva um modelo ou anexe uma fotografia, e o Codex gera-o, texturiza-o e guarda o ficheiro no seu projeto.

Visão geral

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

  • 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 UV, rigging automático e animação para personagens humanóides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • Meshy 3D Printing: análise e reparação de imprimibilidade, 3MF monocromático e multicolor, dimensionamento para medidas reais, produtos Creative Lab (figuras, candeeiros, porta-chaves, íman de frigorífico) e transferência para um software de corte instalado.

Ambas as capacidades acionam o Meshy CLI no seu computador. Inicia sessão uma vez no seu navegador e nunca cola uma chave de API na conversa. Os ficheiros ficam na pasta que indicar, com uma pré-visualização renderizada e os IDs de tarefa de que o Codex necessita para edições subsequentes.

Requisitos

  • Codex, na aplicação de ambiente de trabalho do ChatGPT ou no Codex CLI. Os plugins não carregam na conversa do ChatGPT num navegador. Os espaços de trabalho profissionais e escolares podem precisar que um administrador autorize plugins.
  • Node.js 22.12 ou mais recente, com npm. Verifique com node --version; se estiver em falta ou for mais antigo, instale a versão LTS atual a partir de nodejs.org.
  • Um plano Meshy pago para geração. Cada tarefa de geração gasta créditos Meshy. Os passos locais de impressão, como redimensionar um modelo ou abri-lo num software de corte, não exigem início de sessão.

Instalação

Na aplicação de ambiente de trabalho do ChatGPT:

  1. Mude para Codex e abra Plugins.
  2. Procure 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 @ numa nova conversa e procure por Meshy, ou pergunte ao Codex quais capacidades Meshy estão disponíveis.

Iniciar sessão

Na primeira vez que pedir um modelo, o plugin verifica a existência do Meshy CLI e de uma sessão existente. Se não existir nenhuma, o Codex mostra uma ligação de início de sessão do Meshy e um código de utilização única:

  1. Abra a ligação e inicie sessão no Meshy.
  2. Introduza o código exatamente como apresentado e depois clique em Connect.
  3. Volte ao Codex. Este continua o pedido que fez.

Página de ligação do Meshy CLI

O código expira após 10 minutos; peça ao Codex um novo código se isso acontecer. O Meshy CLI guarda a sessão no seu computador e reutiliza-a em conversas posteriores. Se MESHY_API_KEY estiver definida no seu ambiente, tem prioridade sobre a sessão do navegador.

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

Exemplos de Comandos

Mencione @Meshy, ou simplesmente descreva a tarefa:

  • Cria uma arca do tesouro low-poly para o meu jogo, com um objetivo de 2000 triângulos, adiciona texturas PBR, e guarda-a como GLB em ./assets.
  • Transforma esta fotografia num modelo 3D texturizado e mantém as suas proporções. (anexar a imagem)
  • Faz o rigging deste personagem humanóide texturizado, adiciona uma animação de caminhada, e exporta-o como FBX.
  • Retexturiza ./assets/chest.glb como bronze envelhecido e guarda-o junto do original.
  • Transforma esta fotografia numa figura de 75 mm, verifica a sua imprimibilidade, e prepara um 3MF multicolor para um software de corte compatível.

Os pedidos de seguimento reutilizam o resultado anterior: faz um LOD de 1500 faces, agora como FBX, redimensiona para 150 mm. Quando não indicar uma pasta, os ficheiros vão para ./meshy_output.

Créditos

A geração, texturização, remesh, rigging, animação e reparação gastam créditos da sua conta Meshy às tarifas da API. A análise de imprimibilidade é gratuita. O Codex estima o custo antes de passos pagos e pergunta antes de gastar além do que aprovou. Adicione pergunta-me antes de gastar créditos a um pedido para aprovar cada passo pago, ou pergunte quantos créditos Meshy tenho? a qualquer momento.

Resolução de problemas

SintomaSolução
O Meshy não aparece depois de digitar @Use a aplicação de ambiente de trabalho 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 iniciar sessão através do navegador. Nunca cole uma chave de API numa conversa.
node ou npm não encontradoInstale o Node.js 22.12 ou mais recente a partir de nodejs.org, depois reinicie o Codex.
O código de início de sessão expirouPeça ao Codex para iniciar novamente o processo de início de sessão. Os códigos são válidos durante 10 minutos.
A geração é recusada por causa do plano ou dos créditosA geração requer um plano pago e créditos suficientes. Verifique o seu plano e saldo em meshy.ai.
Sessão iniciada na conta Meshy erradaPeça ao Codex para executar meshy auth logout, depois inicie sessão 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.

Links Relacionados