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

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

Могу ли я установить только навык 3D-печати?

Да. meshy-3d-printing устанавливается и работает самостоятельно, включая шаги генерации, необходимые для печати.

Работает ли это, когда Hermes запущен на удалённом сервере?

Да. При входе в систему отображается ссылка и код, которые можно подтвердить из любого браузера.

Это те же навыки, что и в плагине для Codex?

Да. Плагин для Codex, Claude Code, Cursor и Hermes Agent — все используют meshy-3d-generation и meshy-3d-printing из открытого репозитория meshy-3d-agent.

Это бесплатно?

Навыки бесплатны и имеют открытый исходный код. Для генерации 3D-моделей требуется платный план Meshy, и при этом расходуются кредиты Meshy по тарифам API. Анализ пригодности к печати бесплатен.

Навыки Meshy для Hermes Agent

Добавьте навыки Meshy в Hermes Agent, чтобы ваш агент мог генерировать 3D-модели, текстуры и анимации, а также подготавливать модели к 3D-печати прямо из чата.

Обзор

У Meshy есть два навыка для Hermes Agent:

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

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

Навыки являются открытым исходным кодом и находятся в репозитории meshy-3d-agent на GitHub.

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

Вам нужен Hermes Agent.
Вам нужен Node.js версии 22.12 или новее с npm на компьютере, на котором запускается Hermes.
Для генерации моделей вам нужен платный план Meshy. Каждая задача генерации расходует кредиты Meshy по тарифам API. Стоимость каждой задачи указана в разделе Цены. Анализ пригодности к печати бесплатен, а локальные шаги печати, такие как изменение масштаба модели или её открытие в слайсере, не требуют входа в систему.

Установка навыков

Чтобы Hermes выполнил настройку самостоятельно, вставьте следующий текст в чат:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Hermes проверит Node.js, установит Meshy CLI и оба навыка, а затем проведёт вас через процесс входа в систему.

Чтобы установить навыки самостоятельно, добавьте их из GitHub с помощью Hermes:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

Вы также можете установить оба навыка с помощью установщика skills:

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

Глобальная установка npm install -g meshy-cli не требуется. Без неё навыки запускают CLI через npm exec. Глобальная установка только ускоряет запуск.

Если Hermes не использует навыки в разговоре, который был открыт во время их установки, начните новую сессию.

При первом запросе модели Hermes запускает процесс входа в Meshy CLI и отправляет вам ссылку и одноразовый код.

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

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

Срок действия кода истекает через 10 минут. Если это произошло, попросите Hermes выдать новый код. Вы можете подтвердить вход в систему из любого браузера, поэтому это также работает, когда Hermes запускается на сервере или через SSH.

Meshy CLI сохраняет сессию в файле ~/.config/meshy/credentials.json. Каждый агент, работающий от имени того же пользователя на этом компьютере, использует эту же сессию. Если задана переменная MESHY_API_KEY, CLI использует этот API-ключ вместо сессии браузера.

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

Опишите задачу своими словами. Например:

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

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

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

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

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

FAQ

Как добавить Meshy в Hermes Agent?: Попросите Hermes перейти по ссылке https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, либо выполните hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation и аналогичную команду для meshy-3d-printing. Также вам понадобится Node.js версии 22.12 или новее с npm.
Нужен ли мне API-ключ Meshy?: Нет. Навыки входят в систему через браузер с помощью одноразового кода, а Meshy CLI сохраняет сессию. Если в вашем окружении уже задана переменная MESHY_API_KEY, Meshy CLI использует её вместо этого.
Могу ли я установить только навык 3D-печати?: Да. meshy-3d-printing устанавливается и работает самостоятельно, включая шаги генерации, необходимые для печати.
Работает ли это, когда Hermes запущен на удалённом сервере?: Да. При входе в систему отображается ссылка и код, которые можно подтвердить из любого браузера.
Это те же навыки, что и в плагине для Codex?: Да. Плагин для Codex, Claude Code, Cursor и Hermes Agent — все используют meshy-3d-generation и meshy-3d-printing из открытого репозитория meshy-3d-agent.
Это бесплатно?: Навыки бесплатны и имеют открытый исходный код. Для генерации 3D-моделей требуется платный план Meshy, и при этом расходуются кредиты Meshy по тарифам API. Анализ пригодности к печати бесплатен.

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