Wandy3D
ОбзорКлючи APIРасходыЖурналОплатаЛимитыЦеныБыстрый старт

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

От фото до GLB за несколько минут.

Полный справочник API

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

    Храните его на сервере в переменной окружения.

    Создать ключ
    export WANDY3D_API_KEY="hg_live_…"

  2. 2. Пополните баланс

    От $5. Проверить баланс можно в любой момент бесплатным вызовом.

    Пополнить
    curl https://api.wandy3d.com/api/platform/balance \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"balance_usd": "<balance>", "month_spent_usd": "<spent>", …}

  3. 3. Сгенерируйте модель

    Отправьте фото, опрашивайте задачу, скачайте 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>"

  4. 4. Полезно знать

    Как ведут себя оплата, ошибки и лимиты.

    • Оплата в каждом ответе
      Платные вызовы отвечают billing.cost_usd и billing.balance_usd, плюс заголовки X-Wandy-Cost-USD / X-Wandy-Balance-USD.
    • Ошибки
      402 insufficient_balance / monthly_limit_reached / key_limit_reached, 429 rate_limited / too_many_jobs. Каждая ошибка — JSON с кодом и сообщением.
    • Автоматические возвраты
      Если задача упала, деньги возвращаются на баланс — вы не платите за модель, которую не получили.
    • Лимиты
      60 запросов в минуту на ключ и 5 задач одновременно на аккаунт. Месячные потолки — на странице лимитов.