Démarrage rapide
D’une photo à un GLB en quelques minutes.
1. Créez une clé API
Conservez-la sur votre serveur dans une variable d’environnement.
export WANDY3D_API_KEY="hg_live_…"2. Rechargez votre solde
À partir de 5 $. Consultez-le à tout moment avec un appel gratuit.
curl https://api.wandy3d.com/api/platform/balance \ -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"balance_usd": "<balance>", "month_spent_usd": "<spent>", …}3. Générez un modèle
Envoyez une photo, interrogez la tâche, téléchargez le GLB. Le prix est débité de votre solde et indiqué dans la réponse.
# 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. Bon à savoir
Le fonctionnement de la facturation, des erreurs et des limites.
- La facturation dans chaque réponseLes appels payants renvoient billing.cost_usd et billing.balance_usd, ainsi que les en-têtes X-Wandy-Cost-USD / X-Wandy-Balance-USD.
- Erreurs402 insufficient_balance / monthly_limit_reached / key_limit_reached, 429 rate_limited / too_many_jobs. Chaque erreur est un JSON avec un code et un message.
- Remboursements automatiquesUne tâche qui échoue est remboursée sur votre solde — vous ne payez jamais un modèle que vous n’avez pas reçu.
- Limites60 requêtes par minute par clé et 5 tâches simultanées par compte. Plafonds mensuels sur la page Limites.

