Bắt đầu nhanh

Từ ảnh đến GLB chỉ trong vài phút.

  1. 1. Tạo khóa API

    Lưu khóa trên máy chủ của bạn trong một biến môi trường.

    export WANDY3D_API_KEY="hg_live_…"
  2. 2. Nạp tiền vào số dư

    Từ $5. Kiểm tra số dư bất cứ lúc nào bằng một lệnh gọi miễn phí.

    curl https://api.wandy3d.com/api/platform/balance \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"balance_usd": "<balance>", "month_spent_usd": "<spent>", …}
  3. 3. Tạo mô hình

    Gửi ảnh, kiểm tra trạng thái tác vụ, tải xuống GLB. Chi phí được trừ vào số dư và hiển thị trong phản hồi.

    # 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. Điều nên biết

    Cách hoạt động của thanh toán, lỗi và giới hạn.

    • Thông tin thanh toán trong mọi phản hồi
      Lệnh gọi trả phí trả về billing.cost_usd và billing.balance_usd, cùng các header X-Wandy-Cost-USD / X-Wandy-Balance-USD.
    • Lỗi
      402 insufficient_balance / monthly_limit_reached / key_limit_reached, 429 rate_limited / too_many_jobs. Mọi lỗi đều là JSON kèm mã và thông báo.
    • Hoàn tiền tự động
      Tác vụ lỗi sẽ được hoàn tiền vào số dư — bạn không bao giờ trả tiền cho mô hình mình không nhận được.
    • Giới hạn
      60 yêu cầu mỗi phút cho mỗi khóa và 5 tác vụ cùng lúc cho mỗi tài khoản. Mức trần hằng tháng có trên trang Giới hạn.