Нужен ли мне API-ключ Meshy?

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

Где сохраняются мои модели?

В папке, которую вы указали в запросе, или в ./meshy_output, если вы её не указали, вместе с изображением предварительного просмотра и идентификаторами задач. Плагин сохраняет файлы на вашем компьютере, а не в веб-приложении Meshy.

В какие форматы файлов может экспортировать плагин?

GLB, FBX, OBJ, STL и USDZ для 3D-объектов, а также одноцветный или многоцветный 3MF для 3D-печати.

Работает ли плагин в ChatGPT в веб-браузере?

Нет. Плагин Meshy работает в Work и Codex, в настольном приложении ChatGPT или в Codex CLI.

Может ли плагин видеть модели, которые я создал на сайте Meshy?

Нет. Плагин Meshy работает только с задачами, созданными через Meshy API, например с теми, которые он создал сам. Чтобы просматривать и скачивать модели из вашей учётной записи Meshy, включая модели с сайта Meshy, используйте Meshy 3D.

Могу ли я использовать те же навыки Meshy в Claude Code или Cursor?

Да. Навыки распространяются с открытым исходным кодом в репозитории meshy-3d-agent на GitHub, и вы можете установить их в Claude Code, Cursor, Gemini CLI и других агентах. Попросите своего агента перейти по адресу https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md.

Плагин Meshy для Codex

Установите плагин Meshy в Codex, чтобы создавать и текстурировать 3D-модели прямо из чата и сохранять файлы в своём проекте.

Обзор

Плагин Meshy находится в каталоге плагинов, общем для ChatGPT и Codex, и работает в Work и Codex, но не в Chat. Чтобы создавать модели в чате ChatGPT, работать с моделями, созданными на сайте Meshy, или пропустить установку, используйте Meshy 3D — другой плагин Meshy из того же каталога. Чтобы сравнить оба варианта, см. Какой плагин Meshy использовать.

У плагина Meshy есть два навыка (skills):

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

Оба навыка запускают Meshy CLI на вашем компьютере. CLI — это пакет meshy-cli из npm. Вы входите в систему один раз в браузере и никогда не вставляете API-ключ в чат.

Плагин сохраняет файлы в указанную вами папку вместе с отрендеренным превью и идентификаторами задач (task ID), которые нужны Codex для последующих правок. Навыки с открытым исходным кодом доступны в репозитории meshy-3d-agent на GitHub.

Перед началом работы

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

Установка плагина

Чтобы установить плагин в настольном приложении ChatGPT, выполните следующие шаги:

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

Чтобы установить плагин в Codex CLI, выполните следующие шаги:

Выполните /plugins.
Установите Meshy.
Начните новую сессию.

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

Пошаговое руководство см. в статье How to Use Meshy Plugin in Codex.

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

Чтобы войти в систему, выполните следующие шаги:

Откройте ссылку.
Если страница запрашивает код, введите его в поле Device code точно так, как его показывает Codex, и нажмите Continue.
Если Meshy предложит вам войти, войдите в свою учётную запись Meshy.
На странице Connect Meshy CLI нажмите Connect. На странице появится надпись Meshy CLI authorized.
Вернитесь в Codex. Codex продолжит выполнение вашего запроса.

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

В Codex CLI при первом запуске может быть запрошен доступ к сети. Разрешите его, чтобы Meshy CLI мог обращаться к Meshy API.

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

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

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

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

Кредиты

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

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

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

В следующей таблице перечислены распространённые проблемы, их причины и способы устранения.

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

Часто задаваемые вопросы

Бесплатен ли плагин Meshy для Codex?: Установка плагина бесплатна. Для генерации 3D-моделей требуется платный тарифный план Meshy, и она расходует кредиты Meshy по тарифам API. Анализ пригодности к печати бесплатен, а локальные шаги, такие как изменение масштаба модели или её открытие в слайсере, не требуют входа в систему.
Нужен ли мне API-ключ Meshy?: Нет. Плагин выполняет вход через браузер с помощью одноразового кода, а Meshy CLI сохраняет сессию на вашем компьютере. Никогда не вставляйте API-ключ в чат. Если в вашем окружении уже задана переменная MESHY_API_KEY, Meshy CLI использует её вместо сессии браузера.
Где сохраняются мои модели?: В папке, которую вы указали в запросе, или в ./meshy_output, если вы её не указали, вместе с изображением предварительного просмотра и идентификаторами задач. Плагин сохраняет файлы на вашем компьютере, а не в веб-приложении Meshy.
В какие форматы файлов может экспортировать плагин?: GLB, FBX, OBJ, STL и USDZ для 3D-объектов, а также одноцветный или многоцветный 3MF для 3D-печати.
Работает ли плагин в ChatGPT в веб-браузере?: Нет. Плагин Meshy работает в Work и Codex, в настольном приложении ChatGPT или в Codex CLI.
Может ли плагин видеть модели, которые я создал на сайте Meshy?: Нет. Плагин Meshy работает только с задачами, созданными через Meshy API, например с теми, которые он создал сам. Чтобы просматривать и скачивать модели из вашей учётной записи Meshy, включая модели с сайта Meshy, используйте Meshy 3D.
Могу ли я использовать те же навыки Meshy в Claude Code или Cursor?: Да. Навыки распространяются с открытым исходным кодом в репозитории meshy-3d-agent на GitHub, и вы можете установить их в Claude Code, Cursor, Gemini CLI и других агентах. Попросите своего агента перейти по адресу https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md.

Чтобы создавать модели в чате ChatGPT, см. Meshy 3D для ChatGPT.
Чтобы использовать те же навыки в Hermes Agent, см. Навыки Meshy для Hermes Agent.
Чтобы использовать те же навыки в OpenClaw, см. Навык Meshy для OpenClaw.
Чтобы вызывать Meshy API из ИИ-агента с собственным API-ключом, см. Интеграция с ИИ.