Wandy3D

Wandy3D API

Создавайте 3D-модели из своего кода, движка или ИИ-агента

Отправьте фото, несколько ракурсов или одну фразу — и получите текстурированную 3D-модель. Её можно экспортировать, распечатать на 3D-принтере, перевести в квадовую сетку, снабдить скелетом или подготовить для игрового движка. Тот же конвейер, что и в студии, — по обычному HTTPS.

Получить API-ключВсе эндпоинты
  • Оплата за вызов с предоплаченного баланса
  • Авторизация по Bearer-ключу
  • 60 запросов в минуту на ключ
  • REST и JSON поверх HTTPS
# 1. Start a generation from a photo (Wandy 2)curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \  -H "Authorization: Bearer $WANDY3D_API_KEY" \  -F "file=@photo.jpg"# → {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", "balance_usd": "<balance>"}, …}

Быстрый старт

Четыре шага от фото до GLB-файла.

  1. 1

    Создайте ключ

    В API-платформе, в разделе «Ключи API», затем пополните баланс API. Ключ показывается один раз — сохраните его в переменной окружения, например WANDY3D_API_KEY.

  2. 2

    Запустите генерацию

    POST/generate/cloud/ultra

    Отправьте одно фото в multipart-поле file. В ответе будет task_id.

  3. 3

    Опрашивайте задачу

    GET/task/{task_id}/status

    Раз в несколько секунд, пока status не станет done; тогда в ответе будет model_id.

  4. 4

    Скачайте модель

    GET/model/{model_id}/export?format=glb

    Для GLB ответ приходит сразу — с временной ссылкой. Другие форматы сначала конвертируются: опрашивайте тот же адрес, пока файл не будет готов.

# 1. Start a generation from a photo (Wandy 2)curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \  -H "Authorization: Bearer $WANDY3D_API_KEY" \  -F "file=@photo.jpg"# → {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", "balance_usd": "<balance>"}, …}# 2. Poll until "status" is "done"curl -s "https://api.wandy3d.com/task/<task_id>/status" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "done", "model_id": "<model_id>", …}# 3. Get a download link, then download the GLBcurl -s "https://api.wandy3d.com/model/<model_id>/export?format=glb" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "ready", "url": "<download_url>", "filename": "<name>.glb", …}curl -L -o model.glb "<download_url>"

Ключи и лимиты

Каждый запрос передаёт ваш ключ в заголовке Authorization.

Authorization: Bearer hg_live_…

Держите ключи в секрете

Ключ действует от вашего имени и тратит ваш баланс API. Используйте его на сервере, в скриптах или CI — но никогда на веб-странице или в мобильном приложении. Утёкший ключ отзовите в API-платформе: он сразу перестанет работать.

Лимит запросов

60 запросов в минуту на ключ. Сверх лимита придёт ответ 429 с полем retry_after — сколько секунд подождать.

До 10 ключей

Заведите по ключу на каждое приложение или машину — тогда один можно отозвать, не трогая остальные.

Ошибки

Ошибки приходят в JSON. У большинства есть стабильный код в detail.error:

{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}
Статусdetail.errorЧто значит
401invalid_api_keyКлюча нет, он неверный или отозван.
402insufficient_balancemonthly_limit_reachedkey_limit_reachedНе хватает баланса API или достигнут месячный лимит (аккаунта или ключа).
403subscription_requiredsession_requiredНужен вход на сайте или план, чтобы скачать модель, сделанную на сайте.
404feature_offНе найдено или пока вам недоступно.
409file_not_readyФайл модели ещё не готов.
429rate_limitedtoo_many_jobsДостигнут лимит запросов или запущено слишком много генераций одновременно.

Цены

Каждый платный вызов оплачивается в долларах США с предоплаченного баланса API. Пополнение картой от $5 — баланс не сгорает, а за упавшие задачи деньги возвращаются автоматически.

Модели, созданные через API, ваши: скачивайте их в любом формате бесплатно.

Цены API

Эндпоинты

Весь публичный API в одной таблице. Каждый маршрут принимает один и тот же Bearer-ключ.

Документ OpenAPI ↗

Генерация

МетодПутьЧто делает
POST/generate/cloud/ultra
Модель по одному фото, Wandy 2Платно
POST/generate/cloud
Модель по одному фото, Wandy 1.1Платно
POST/generate/cloud/fast
Модель по одному фото, Wandy 1Платно
POST/generate/cloud/multi/ultra
Модель по 2–4 ракурсам, Wandy 2Платно
POST/generate/cloud/multi
Модель по 2–4 ракурсам одного объекта, Wandy 1.1Платно
POST/generate/cloud/multi/fast
Модель по 2–4 ракурсам, Wandy 1Платно
POST/generate/text/imagine
Текстовый запрос → концепт-картинкаПлатно
POST/generate/text
Концепт-картинка → 3D-модельПлатно
POST/generate/retexture
Новая текстура модели по фотоПлатно

Задачи

МетодПутьЧто делает
GET/task/{task_id}/status
Ход генерации

Библиотека

МетодПутьЧто делает
GET/library
Ваши модели, сначала новые
GET/model/{model_id}
Одна модель и ссылка на её GLB

Скачивание и обработка

МетодПутьЧто делает
GET/model/{model_id}/export
Скачать в GLB, FBX, OBJ, USDZ, STL или Draco GLBСкачивание
GET/model/{model_id}/print
STL или 3MF для 3D-печатиСкачивание
GET/model/{model_id}/retopo
Квадовая сетка с запечёнными текстурамиПлатноСкачивание
GET/model/{model_id}/rig
Автоматический скелет с анимациямиПлатно
GET/model/{model_id}/parts
Разделить модель на частиПлатно
GET/model/{model_id}/gamepack
Игровой пакет с LOD и коллайдерамиПлатноСкачивание
GET/model/{model_id}/make/{kind}
Поделки, например бумажная модельПлатно

Аккаунт

МетодПутьЧто делает
GET/api/platform/balance
Баланс API
GET/api/platform/prices
Актуальные цены

Сделайте первый вызов API

Создайте ключ и пополните баланс в API-платформе — это займёт минуту.

Получить API-ключ