Плагін 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, автоматичний рігінг (auto-rigging) та анімація для гуманоїдних персонажів, а також експорт у 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 для комп’ютера, виконайте такі кроки:

  1. У застосунку ChatGPT для комп’ютера перейдіть у Codex.

  2. Відкрийте Plugins.

  3. Знайдіть Meshy, а потім відкрийте плагін Meshy.

  4. Натисніть Install plugin.

    Сторінка плагіна Meshy в каталозі плагінів Codex з кнопкою Install plugin і трьома прикладами запитів

  5. Розпочніть новий чат. Codex завантажує плагіни лише в чатах, які ви відкриваєте після встановлення.

Щоб встановити плагін у Codex CLI, виконайте такі кроки:

  1. Виконайте /plugins.

  2. Встановіть Meshy.

  3. Розпочніть нову сесію.

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

Покроковий посібник наведено в How to Use Meshy Plugin in Codex.


Вхід у систему

Коли ви вперше запитуєте модель, плагін перевіряє наявність Meshy CLI та збереженої сесії Meshy. Якщо сесію не знайдено, Codex показує посилання для входу в Meshy та одноразовий код.

Щоб увійти в систему, виконайте такі кроки:

  1. Відкрийте посилання.

  2. Якщо сторінка запитує код, введіть код у поле Device code точно так, як показує Codex, а потім натисніть Continue.

  3. Якщо Meshy просить увійти, увійдіть у свій обліковий запис Meshy.

  4. На сторінці Connect Meshy CLI натисніть Connect. Сторінка покаже Meshy CLI authorized.

    Сторінка Connect Meshy CLI з обліковим записом, у який виконано вхід, доступом, який отримує CLI, і кнопками Cancel та Connect

  5. Поверніться в 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 або npmNode.js не встановлено, або Codex не може його знайти.Встановіть Node.js версії 22.12 або новішої з вебсайту Node.js, а потім перезапустіть Codex.
Термін дії коду входу сплинувКод дійсний протягом 10 хвилин.Попросіть Codex знову розпочати вхід у систему.
Codex не може генерувати через підписку чи кредитиГенерація потребує платної підписки й достатньої кількості кредитів.Перевірте свою підписку й баланс на сторінці Subscription у веб-застосунку Meshy.
Ви увійшли не в той обліковий запис MeshyMeshy CLI повторно використовує сесію, збережену на вашому комп’ютері.Попросіть Codex виконати meshy auth logout, а потім увійти знову.

FAQ

Чи безкоштовний плагін 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.