meshy-ai
Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment.
How to use
Przygotuj klucz API: utwórz zmienną środowiskową MESHY_API_KEY z wartością msy-... (opcjonalnie możesz też ustawić MESHY_BASE_URL, jeśli używasz niestandardowego serwera).
Do generowania obrazu z tekstu użyj skryptu text_to_image.py z parametrem --prompt zawierającym opis, co chcesz wygenerować, oraz --out-dir wskazujący folder docelowy. Skrypt automatycznie pobierze wygenerowane obrazy (w tym warianty wielowidokowe, jeśli dostępne) do podkatalogu text-to-image_[ID]_[slug].
Do konwersji obrazu na model 3D użyj skryptu image_to_3d_obj.py. Możesz podać ścieżkę do lokalnego pliku PNG za pomocą --image lub publiczny URL obrazu za pomocą --image-url.
Określ folder wyjściowy parametrem --out-dir — skrypt automatycznie pobierze model.obj (oraz model.mtl, jeśli Meshy go udostępni) do podkatalogu image-to-3d_[ID]_[slug].
Pamiętaj, że zadania Meshy.ai działają asynchronicznie: umiejętność tworzy zadanie, czeka na jego ukończenie (status=SUCCEEDED), a następnie pobiera gotowe pliki. Cały proces odbywa się automatycznie — nie musisz ręcznie monitorować postępu.