Плагин Meshy для Codex

Официальный плагин Meshy для Codex превращает чат в 3D-ассеты. Опишите модель или прикрепите фото, и Codex сгенерирует её, наложит текстуры и сохранит файл в вашем проекте.


Обзор

Meshy теперь доступен в каталоге плагинов ChatGPT (Codex) с двумя навыками:

  • Meshy 3D Generation: текст в 3D, изображение в 3D и мультивид в 3D, AI-текстурирование и ретекстурирование, ремеш до заданного полигонального бюджета, развёртка UV, авто-риггинг и анимация для гуманоидных персонажей, а также экспорт в GLB, FBX, OBJ, STL или USDZ.
  • Meshy 3D Printing: анализ и исправление пригодности к печати, одноцветный и многоцветный 3MF, подгонка под реальные размеры, продукты Creative Lab (фигурки, лампы, брелоки, магниты на холодильник) и передача в установленный слайсер.

Оба навыка управляют Meshy CLI на вашем компьютере. Вы входите в систему один раз в браузере и никогда не вставляете API-ключ в чат. Файлы попадают в указанную вами папку вместе с отрендеренным превью и ID задач, которые нужны Codex для последующих правок.


Требования

  • Codex в приложении ChatGPT для компьютера или в Codex CLI. Плагины не загружаются в чате ChatGPT в браузере. Для рабочих и учебных рабочих областей может потребоваться разрешение администратора на использование плагинов.
  • Node.js 22.12 или новее с npm. Проверьте версию командой node --version; если его нет или версия устарела, установите текущую LTS-версию с nodejs.org.
  • Платный план Meshy для генерации. Каждая задача генерации расходует кредиты Meshy. Локальные шаги печати, такие как изменение масштаба модели или её открытие в слайсере, не требуют входа в систему.

Установка

В приложении ChatGPT для компьютера:

  1. Переключитесь на Codex и откройте Plugins.
  2. Найдите Meshy и нажмите Install plugin.
  3. Начните новый чат. Плагины загружаются только в чатах, открытых после установки.

Meshy в каталоге плагинов Codex

В Codex CLI: выполните /plugins, установите Meshy, затем начните новую сессию.

Чтобы убедиться, что установка прошла успешно, введите @ в новом чате и найдите Meshy, или спросите Codex, какие навыки Meshy доступны.


Вход в систему

При первом запросе модели плагин проверяет наличие Meshy CLI и существующей сессии. Если её нет, Codex показывает ссылку для входа в Meshy и одноразовый код:

  1. Откройте ссылку и войдите в Meshy.
  2. Введите код точно так, как показано, затем нажмите Connect.
  3. Вернитесь в Codex. Он продолжит выполнение вашего запроса.

Страница подключения Meshy CLI

Код действителен в течение 10 минут; если он истёк, попросите Codex сгенерировать новый. Meshy CLI сохраняет сессию на вашем компьютере и использует её в последующих чатах. Если в вашем окружении задана переменная MESHY_API_KEY, она имеет приоритет над сессией браузера.


Примеры запросов

Упомяните @Meshy или просто опишите задачу:

  • Создай низкополигональный сундук с сокровищами для моей игры, целевой показатель — 2000 треугольников, добавь PBR-текстуры и сохрани как GLB в ./assets.
  • Преврати это фото в текстурированную 3D-модель с сохранением пропорций. (прикрепите изображение)
  • Сделай риггинг этого текстурированного гуманоидного персонажа, добавь анимацию ходьбы и экспортируй в FBX.
  • Сделай ретекстурирование ./assets/chest.glb под состаренную бронзу и сохрани рядом с оригиналом.
  • Преврати это фото в фигурку размером 75 мм, проверь её пригодность к печати и подготовь многоцветный 3MF для совместимого слайсера.

Последующие запросы используют предыдущий результат: сделай LOD на 1500 граней, теперь в FBX, масштабируй до 150 мм. Если вы не указали папку, файлы сохраняются в ./meshy_output.


Кредиты

Генерация, текстурирование, ремеш, риггинг, анимация и исправление расходуют кредиты с вашего аккаунта Meshy по тарифам API. Анализ пригодности к печати бесплатен. Codex оценивает стоимость перед платными шагами и запрашивает подтверждение, прежде чем потратить больше, чем вы одобрили. Добавьте в запрос фразу спрашивай меня перед тратой кредитов, чтобы подтверждать каждый платный шаг, или в любой момент спросите сколько у меня кредитов Meshy?.


Устранение неполадок

СимптомРешение
Meshy не появляется после ввода @Используйте приложение ChatGPT для компьютера или Codex CLI, а не чат в браузере. Перезапустите Codex и откройте новый чат.
Codex запрашивает API-ключОткажитесь и попросите его войти через браузер. Никогда не вставляйте API-ключ в чат.
node или npm не найденУстановите Node.js версии 22.12 или новее с nodejs.org, затем перезапустите Codex.
Код входа истёкПопросите Codex снова начать вход в систему. Коды действительны в течение 10 минут.
Генерация отклонена из-за плана или кредитовДля генерации нужен платный план и достаточно кредитов. Проверьте свой план и баланс на meshy.ai.
Выполнен вход не в тот аккаунт MeshyПопросите Codex выполнить meshy auth logout, затем войдите снова.

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.