Czy potrzebuję klucza API Meshy?

Nie. Umiejętności logują się przez przeglądarkę za pomocą jednorazowego kodu, a CLI Meshy przechowuje sesję. Jeśli zmienna MESHY_API_KEY jest już ustawiona w Twoim środowisku, CLI Meshy używa jej zamiast tego.

Czy mogę zainstalować tylko umiejętność druku 3D?

Tak. meshy-3d-printing instaluje się i działa samodzielnie, w tym kroki generowania potrzebne do wydruku.

Czy to działa, gdy Hermes działa na zdalnym serwerze?

Tak. Logowanie wyświetla link i kod, który możesz zatwierdzić z dowolnej przeglądarki.

Czy to te same umiejętności co we wtyczce Codex?

Tak. Wtyczka Codex, Claude Code, Cursor oraz Hermes Agent korzystają z meshy-3d-generation i meshy-3d-printing z otwartoźródłowego repozytorium meshy-3d-agent.

Umiejętności są darmowe i open source. Generowanie modeli 3D wymaga płatnego planu Meshy i zużywa kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna.

Umiejętności Meshy dla Hermes Agent

Dodaj umiejętności Meshy do Hermes Agent, aby Twój agent mógł generować modele 3D, tekstury i animacje oraz przygotowywać wydruki 3D bezpośrednio z czatu.

Przegląd

Meshy udostępnia dwie umiejętności dla Hermes Agent:

meshy-3d-generation: Tekst na 3D, Obraz na 3D i Wiele obrazów na 3D, teksturowanie i retekturowanie AI, remesh do budżetu wielokątów, rozkładanie UV, automatyczny rigging i animacja postaci humanoidalnych oraz eksport do GLB, FBX, OBJ, STL lub USDZ.
meshy-3d-printing: analiza i naprawa drukowalności, jednokolorowy i wielokolorowy format 3MF, dopasowywanie rozmiaru do rzeczywistych wymiarów, produkty Creative Lab, takie jak figurki, lampy, breloki i magnesy na lodówkę, oraz przekazanie do zainstalowanego slicera.

Każda umiejętność instaluje się niezależnie, więc możesz dodać samą umiejętność drukowania, jeśli to wszystko, czego potrzebujesz. Obie umiejętności uruchamiają CLI Meshy, czyli pakiet meshy-cli na npm. Logujesz się raz w przeglądarce i nie potrzebujesz klucza API.

Umiejętności są open source w repozytorium meshy-3d-agent na GitHubie.

Zanim zaczniesz

Potrzebujesz Hermes Agent.
Potrzebujesz Node.js w wersji 22.12 lub nowszej, wraz z npm, na komputerze, na którym działa Hermes.
Aby generować modele, potrzebujesz płatnego planu Meshy. Każde zadanie generowania zużywa kredyty Meshy według stawek API. Koszt każdego zadania znajdziesz w sekcji Cennik. Analiza drukowalności jest bezpłatna, a lokalne kroki druku, takie jak zmiana skali modelu lub otwarcie go w slicerze, nie wymagają logowania.

Instalacja umiejętności

Aby Hermes wykonał konfigurację za Ciebie, wklej poniższy tekst na czacie:

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

Hermes sprawdza Node.js, instaluje CLI Meshy oraz obie umiejętności, a następnie przeprowadza Cię przez proces logowania.

Aby samodzielnie zainstalować umiejętności, dodaj je z GitHuba za pomocą 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

Możesz też zainstalować obie umiejętności za pomocą instalatora skills:

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

Nie musisz globalnie instalować npm install -g meshy-cli. Bez tego umiejętności uruchamiają CLI przez npm exec. Instalacja globalna tylko przyspiesza uruchamianie.

Jeśli Hermes nie korzysta z umiejętności w rozmowie, która była otwarta podczas ich instalacji, rozpocznij nową sesję.

Przy pierwszej prośbie o model Hermes rozpoczyna logowanie przez CLI Meshy i wysyła Ci link oraz jednorazowy kod.

Aby się zalogować, wykonaj następujące kroki:

Otwórz link na dowolnym urządzeniu.
Jeśli strona poprosi o kod, wpisz kod w polu Device code dokładnie tak, jak pokazuje go Hermes, a następnie kliknij Continue.
Jeśli Meshy poprosi Cię o zalogowanie, zaloguj się na swoje konto Meshy.
Na stronie Connect Meshy CLI kliknij Connect. Strona wyświetli komunikat Meshy CLI authorized.
Wróć do czatu. Hermes kontynuuje wykonywanie Twojego żądania.

Kod wygasa po 10 minutach. Jeśli wygaśnie, poproś Hermesa o nowy. Logowanie możesz zatwierdzić z dowolnej przeglądarki, więc działa to również wtedy, gdy Hermes działa na serwerze lub przez SSH.

CLI Meshy przechowuje sesję w pliku ~/.config/meshy/credentials.json. Każdy agent działający jako ten sam użytkownik na danym komputerze korzysta z tej samej sesji. Jeśli ustawiono zmienną MESHY_API_KEY, CLI używa zamiast tego tego klucza API.

Przykładowe polecenia

Opisz zadanie własnymi słowami. Na przykład:

Stwórz model 3D szczeniaka husky i zapisz go jako GLB w ./assets.
Zamień to zdjęcie na teksturowany model 3D i zachowaj jego proporcje. (dołącz obraz)
Stwórz trzy butelki z miksturą w stylu low-poly do mojej gry, każdą poniżej 1500 trójkątów.
Zriguj tę postać humanoidalną, dodaj animację chodu i wyeksportuj ją jako FBX.
Pomóż mi wydrukować w 3D małą figurkę smoka, wysoką na 80 mm, jako wielokolorowy 3MF.

Kolejne żądania wykorzystują poprzedni wynik, na przykład stwórz LOD na 1500 ścian, teraz jako FBX lub przeskaluj do 150 mm. Aby samodzielnie zatwierdzać każdy płatny krok, dodaj do swojego żądania zapytaj mnie przed wydaniem kredytów.

Rozwiązywanie problemów

Poniższa tabela zawiera listę typowych problemów, ich przyczyny oraz sposoby rozwiązania.

Problem	Przyczyna	Rozwiązanie
Hermes nie korzysta z umiejętności Meshy	Hermes nie wczytał umiejętności w otwartej rozmowie lub nie dopasował do nich Twojego żądania.	Rozpocznij nową sesję lub wspomnij o Meshy w swoim żądaniu.
Nie znaleziono `node` lub `npm`	Node.js nie jest zainstalowany lub Hermes nie może go znaleźć.	Zainstaluj Node.js w wersji 22.12 lub nowszej ze strony Node.js, a następnie uruchom ponownie Hermes.
Hermes prosi o klucz API	Umiejętności go nie potrzebują. Logowanie odbywa się przez przeglądarkę.	Odmów i poproś Hermesa, aby zamiast tego zalogował się przez przeglądarkę. Nigdy nie wklejaj klucza API na czacie.
Kod logowania wygasł	Kod jest ważny przez 10 minut.	Poproś Hermesa o ponowne rozpoczęcie logowania.
Hermes nie może wygenerować modelu z powodu planu lub kredytów	Generowanie wymaga płatnego planu i wystarczającej liczby kredytów.	Sprawdź swój plan i saldo na stronie Subskrypcja w aplikacji webowej Meshy.
Jesteś zalogowany na niewłaściwe konto Meshy	CLI Meshy ponownie wykorzystuje sesję zapisaną na Twoim komputerze.	Poproś Hermesa o uruchomienie `meshy auth logout`, a następnie zaloguj się ponownie.

FAQ

Jak dodać Meshy do Hermes Agent?: Poproś Hermesa, aby wykonał instrukcje z https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, lub uruchom hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation oraz to samo polecenie dla meshy-3d-printing. Potrzebujesz również Node.js w wersji 22.12 lub nowszej wraz z npm.
Czy potrzebuję klucza API Meshy?: Nie. Umiejętności logują się przez przeglądarkę za pomocą jednorazowego kodu, a CLI Meshy przechowuje sesję. Jeśli zmienna MESHY_API_KEY jest już ustawiona w Twoim środowisku, CLI Meshy używa jej zamiast tego.
Czy mogę zainstalować tylko umiejętność druku 3D?: Tak. meshy-3d-printing instaluje się i działa samodzielnie, w tym kroki generowania potrzebne do wydruku.
Czy to działa, gdy Hermes działa na zdalnym serwerze?: Tak. Logowanie wyświetla link i kod, który możesz zatwierdzić z dowolnej przeglądarki.
Czy to te same umiejętności co we wtyczce Codex?: Tak. Wtyczka Codex, Claude Code, Cursor oraz Hermes Agent korzystają z meshy-3d-generation i meshy-3d-printing z otwartoźródłowego repozytorium meshy-3d-agent.
Czy to jest darmowe?: Umiejętności są darmowe i open source. Generowanie modeli 3D wymaga płatnego planu Meshy i zużywa kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna.

Aby używać tych samych umiejętności w Codex, zobacz Wtyczka Meshy dla Codex.
Aby używać tych samych umiejętności w OpenClaw, zobacz Umiejętność Meshy dla OpenClaw.
Aby wywoływać Meshy API z poziomu agenta AI za pomocą własnego klucza API, zobacz Integracja z AI.