С какого тарифа работает API и как сделать первый запрос
API Meshy открывается с тарифа Pro и выше. Запросы списывают кредиты из баланса аккаунта, а текстуры в API генерируются с разрешением до 8K.
Ключ создаётся на странице API в аккаунте после входа. Задача «текст в 3D» отправляется запросом POST на /openapi/v2/text-to-3d, а ключ передаётся в заголовке Authorization. Сначала проверьте генерацию в веб-версии Meshy: добейтесь нужного результата описанием и настройками, потом переносите параметры в код.
Как устроена задача в API
Запрос создаёт задачу. Дальше она проходит статусы PENDING, IN_PROGRESS и один из финальных: SUCCEEDED, FAILED или CANCELED. Готовый результат приходит в форматах GLB, FBX, STL и других.
О готовности сообщает вебхук: уведомление приходит само, когда задача завершена. Подпишитесь на вебхук вместо того, чтобы опрашивать статус каждые несколько секунд.
Результаты хранятся 3 дня, на тарифе Studio 14 дней. Файлы забирайте сразу после готовности.
Какие у API лимиты
Лимит составляет 20 запросов в секунду на тарифах Pro, Premium и Studio, на Enterprise 100. Одновременно в очереди может висеть 10 задач на Pro, 30 на Premium и 60 на Studio. При запуске пачки задач следите, чтобы очередь не выходила за пределы тарифа.
Отдельные операции оплачиваются кредитами; цена генерации сетки зависит от модели.
Что работает без программирования
Плагины Meshy есть для Blender, Unity, Unreal Engine, Maya, 3ds Max и Roblox Studio. Генерация и экспорт идут внутри программы, без кода.
Для ассистентов в редакторах кода есть MCP-сервер. Ещё есть CLI — утилита командной строки, которая ставится через npm.
На тарифе Studio доступны консоль API и ограниченная песочница, на Enterprise полный доступ к песочнице и постоянное хранение результатов.