API Wandy3D
Générez des modèles 3D depuis votre code, votre moteur ou votre agent IA
Envoyez une photo, quelques vues ou une phrase et recevez un modèle 3D texturé — puis exportez-le, imprimez-le, remaillez-le en quads, ajoutez-lui un rig ou préparez-le pour votre moteur de jeu. Le même pipeline que le studio, en simple HTTPS.
À partir de 0,09 $US par modèle (Wandy 1) · Wandy 2 0,18 $US
2,00 $US offerts pour essayer — environ 11 modèles Wandy 2 ou 22 modèles Wandy 1 avec votre première clé API.
- Solde prépayé sans expiration · sans abonnement
- Authentification par clé Bearer
- 60 requêtes par minute et par clé
- REST et JSON via 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>"}, …}Démarrage rapide
Quatre étapes, d’une photo à un fichier GLB.
- 1
Créez une clé
Dans la plateforme API, rubrique Clés API, puis rechargez votre solde API. La clé n’est affichée qu’une fois — conservez-la dans une variable d’environnement comme
WANDY3D_API_KEY. - 2
Lancez une génération
POST
/generate/cloud/ultraEnvoyez une photo dans le champ multipart
file. La réponse contient untask_id. - 3
Interrogez la tâche
GET
/task/{task_id}/statusToutes les quelques secondes, jusqu’à ce que
statusvailledone; la réponse contient alors lemodel_id. - 4
Téléchargez
GET
/model/{model_id}/export?format=glbLe GLB est renvoyé immédiatement avec un lien temporaire. Les autres formats sont d’abord convertis — interrogez la même URL jusqu’à ce que le fichier soit prêt.
# 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>"Clés et limites
Chaque requête transmet votre clé dans l’en-tête Authorization.
Authorization: Bearer hg_live_…Gardez vos clés secrètes
Une clé agit en votre nom et dépense votre solde API. Utilisez-la depuis votre serveur, vos scripts ou votre CI — jamais dans une page web ou une application mobile. Révoquez une clé divulguée dans la plateforme API : elle cesse aussitôt de fonctionner.
Limite de débit
60 requêtes par minute et par clé. Au-delà, la réponse est un 429 avec retry_after — le nombre de secondes à attendre.
Jusqu’à 10 clés
Utilisez-en une par application ou par machine, pour pouvoir en révoquer une sans toucher aux autres.
Erreurs
Les erreurs sont au format JSON. La plupart comportent un code stable dans detail.error :
{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}| Statut | detail.error | Signification |
|---|---|---|
| 400 | invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_image | La requête ne peut pas être traitée telle quelle : lien d’image impossible à télécharger, paramètre ou URL de callback invalide. Rien n’est facturé. |
| 401 | invalid_api_key | La clé est absente, incorrecte ou révoquée. |
| 402 | insufficient_balancemonthly_limit_reachedkey_limit_reached | Solde API insuffisant, ou limite mensuelle (du compte ou de la clé) atteinte. |
| 403 | subscription_requiredsession_required | Nécessite une session connectée sur le site, ou une formule pour télécharger un modèle créé sur le site. |
| 404 | feature_off | Introuvable, ou pas encore accessible pour vous. |
| 409 | file_not_ready | Le fichier du modèle n’est pas encore prêt. |
| 409 | idempotency_key_reusedidempotency_in_progress | Cette Idempotency-Key a déjà été utilisée avec une autre requête, ou sa première requête est encore en cours. |
| 429 | rate_limitedtoo_many_jobs | Limite de débit atteinte, ou trop de générations en cours en même temps. |
Tarifs
Le coût d’un modèle, en dollars US, selon la grille tarifaire actuelle de l’API.
| Version | Une photo | 2–4 vues |
|---|---|---|
Wandy 1/generate/cloud/fast | 0,09 $US | 0,24 $US |
Wandy 1.1/generate/cloud | 0,15 $US | 0,27 $US |
Wandy 2/generate/cloud/ultra | 0,18 $US | 0,30 $US |
Chaque appel payant est débité en dollars US sur votre solde API prépayé. Rechargez par carte dès 5 $ — le solde n’expire jamais et les tâches échouées sont remboursées automatiquement.
Les modèles générés via l’API sont à vous : téléchargez-les gratuitement dans tous les formats.
Les nouveaux comptes connectés avec Google ou Apple reçoivent 2,00 $US sur leur première clé API — une seule fois, sans carte bancaire.
Endpoints
L’API publique en un seul tableau. Chaque route accepte la même clé Bearer.
Génération
| Méthode | Chemin | Description |
|---|---|---|
| POST | /generate/cloud/ultra | Modèle à partir d’une photo, Wandy 2Payant |
| POST | /generate/cloud | Modèle à partir d’une photo, Wandy 1.1Payant |
| POST | /generate/cloud/fast | Modèle à partir d’une photo, Wandy 1Payant |
| POST | /generate/cloud/multi/ultra | Modèle à partir de 2 à 4 vues, Wandy 2Payant |
| POST | /generate/cloud/multi | Modèle à partir de 2–4 vues d’un même objet, Wandy 1.1Payant |
| POST | /generate/cloud/multi/fast | Modèle à partir de 2 à 4 vues, Wandy 1Payant |
| POST | /generate/text/imagine | Prompt texte → image de conceptPayant |
| POST | /generate/text | Image de concept → modèle 3DPayant |
| POST | /generate/retexture | Nouvelle texture d’un modèle à partir d’une photoPayant |
Tâches
| Méthode | Chemin | Description |
|---|---|---|
| GET | /task/{task_id}/status | Progression d’une génération |
| GET | /api/generate/eta | Durée actuelle d’une génération |
Bibliothèque
| Méthode | Chemin | Description |
|---|---|---|
| GET | /library | Vos modèles, du plus récent au plus ancien |
| GET | /model/{model_id} | Un modèle, son lien GLB et ce qu’il représente |
| DELETE | /model/{model_id} | Supprimer un modèle |
| GET | /model/{model_id}/versions | Toutes les versions d’un modèle et les fichiers créés à partir d’elles |
Téléchargements et post-traitement
| Méthode | Chemin | Description |
|---|---|---|
| GET | /model/{model_id}/stream | Le fichier GLB du modèleTéléchargement |
| GET | /model/{model_id}/export | Télécharger en GLB, FBX, OBJ, USDZ, STL ou Draco GLBTéléchargement |
| GET | /model/{model_id}/print | STL ou 3MF prêt à imprimer, avec rapport de vérificationTéléchargement |
| GET | /model/{model_id}/retopo | Remaillage en quads ou Low Poly avec textures précalculéesPayantTéléchargement |
| GET | /model/{model_id}/rig | Rigging automatique avec clips d’animationPayant |
| GET | /model/{model_id}/parts | Découper un modèle en piècesPayant |
| GET | /model/{model_id}/gamepack | Pack prêt pour le jeu avec LOD et collidersPayantTéléchargement |
| GET | /model/{model_id}/make/{kind} | Loisirs créatifs, par exemple papercraftPayant |
| GET | /model/{model_id}/outputs/{output_id} | Rouvrir un fichier créé précédemment |
| GET | /model/{model_id}/rig/suggest | Quel rig convient — gratuit, avant de payer |
Compte
| Méthode | Chemin | Description |
|---|---|---|
| GET | /api/platform/balance | Votre solde API |
| GET | /api/platform/prices | La grille tarifaire à jour |
Chaque réponse et chaque erreur de chaque opération est typée dans le document OpenAPI, avec des exemples. Générez un client à partir de celui-ci ou confiez-le à votre agent de code.
Liens et relances
Envoyez un lien au lieu d’importer un fichier, et relancez une requête sans payer deux fois.
Une photo par lien
Chaque route photo accepte aussi du JSON avec image_url ; pour plusieurs vues, image_urls. Nous téléchargeons l’image et la traitons exactement comme un fichier importé. Le lien doit être en https vers une adresse publique, et le fichier un JPEG, PNG ou WebP de 20 Mo maximum. Un lien inutilisable renvoie une erreur 400 avant toute facturation.
# One photo by link (Wandy 2) — no uploadcurl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image_url": "https://images.example.org/chair.jpg"}'# → {"task_id": "<task_id>", "status": "queued", "billing": {…}}# Several views of one object: image_urls, front view firstcurl -s -X POST "https://api.wandy3d.com/generate/cloud/multi/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image_urls": ["https://images.example.org/front.jpg", "https://images.example.org/side.jpg"]}'# A link we can't use → 400, nothing is charged# {"detail": {"error": "invalid_image_url", "message": "image_url must use https://."}}Relances sans risque
Ajoutez un en-tête Idempotency-Key à un POST payant. Si la même requête arrive à nouveau dans les 24 heures — un délai dépassé, une relance de votre file d’attente —, vous recevez la première réponse avec le même task_id, et rien n’est relancé ni facturé une seconde fois. La même clé avec une requête différente renvoie 409.
KEY=$(uuidgen) # one key per job you want to exist oncecurl -si -X POST "https://api.wandy3d.com/generate/cloud/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Idempotency-Key: $KEY" \ -H "Content-Type: application/json" \ -d '{"image_url": "https://images.example.org/chair.jpg"}'# → 200 {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", …}}# The connection dropped? Send exactly the same request again (within 24 hours):# → 200, header Idempotent-Replayed: true, the same "task_id" — no second job, no second charge# The same key with a different request → 409# {"detail": {"error": "idempotency_key_reused", "message": "…"}}Webhooks
Plus besoin d’interroger l’API : ajoutez callback_url au lancement d’une génération et nous envoyons un événement signé en POST à votre serveur lorsqu’elle se termine.
curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra?callback_url=https://your.app/hooks/wandy3d" \ -H "Authorization: Bearer $WANDY3D_API_KEY" -F "file=@photo.jpg"# → {"task_id": "…", "webhook": {"callback_url": "https://your.app/hooks/wandy3d", …}}# When the model is ready (or the job fails) we POST one signed event to that URL.Événements
task.completed — le modèle est prêt, avec son id, son nom et des liens vers le modèle et son export GLB. task.failed — la tâche a échoué et son montant a été recrédité sur votre solde API. ping — un test envoyé depuis le tableau de bord.
Signés
Chaque événement contient Wandy-Signature: t=…,v1=… — v1 est le HMAC-SHA256 de l’horodatage, d’un point et du corps brut, avec pour clé le secret webhook de la clé API qui a lancé la tâche. Rejetez les événements datant de plus de 5 minutes.
Relancés
Répondez par n’importe quel 2xx sous 10 secondes. Sinon, l’envoi est relancé 3 fois — après 30 s, 2 min et 10 min — avec le même id d’événement, pour écarter facilement les doublons.
POST /hooks/wandy3dWandy-Signature: t=1761900000,v1=5f0c…Wandy-Event-Id: evt_…Wandy-Event-Type: task.completed{ "id": "evt_…", "type": "task.completed", "created_at": "…", "data": { "task_id": "…", "status": "done", "model_id": "…", "name": "…", "model_url": "https://api.wandy3d.com/model/<model_id>", "export_url": "https://api.wandy3d.com/model/<model_id>/export?format=glb", "cost_usd": "…" }}import crypto from "node:crypto";import express from "express";const app = express();// The signature covers the raw body: read it as bytes, parse after the check.app.post("/hooks/wandy3d", express.raw({ type: "application/json" }), (req, res) => { const parts = Object.fromEntries( (req.get("Wandy-Signature") ?? "").split(",").map((p) => p.split("=")), ); const expected = crypto .createHmac("sha256", process.env.WANDY3D_WEBHOOK_SECRET) .update(`${parts.t}.`) .update(req.body) .digest("hex"); const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300; const valid = typeof parts.v1 === "string" && parts.v1.length === expected.length && crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected)); if (!fresh || !valid) return res.sendStatus(400); const event = JSON.parse(req.body.toString("utf8")); if (event.type === "task.completed") { console.log("model ready:", event.data.model_id, event.data.export_url); } res.sendStatus(200); // answer fast; do slow work after});app.listen(3000);Utiliser avec des agents IA
Connectez Wandy3D à Claude, ChatGPT, Cursor, VS Code ou toute app compatible MCP. Demandez un modèle 3D en langage courant : l’assistant le crée dans votre compte Wandy3D et l’affiche directement dans le chat.
URL du serveur
https://wandy3d.com/mcpAjoutez-le à votre éditeur en un clic
L’éditeur s’ouvre et vous demande confirmation avant d’ajouter le serveur. La consultation des exemples de modèles et des prix fonctionne immédiatement. Pour générer, collez d’abord votre clé API : les boutons la transmettront aux paramètres de l’éditeur.
La clé reste dans votre navigateur : elle est uniquement ajoutée au lien qui ouvre votre éditeur.
Deux façons de se connecter
Se connecter avec Wandy3D
Claude, ChatGPT et autres apps de chat avec connecteurs
- Dans les paramètres des connecteurs de l’app, ajoutez un connecteur personnalisé avec l’URL du serveur ci-dessus.
- Connectez-vous avec Wandy3D lorsque l’app vous le demande, puis autorisez la connexion.
- Demandez un modèle. Il est créé avec vos crédits Wandy3D, aux prix du site.
Utiliser une clé API
Claude Code, Cursor, VS Code et vos propres scripts
- Créez une clé sur la plateforme API et rechargez votre solde API.
- Ajoutez le serveur avec la clé dans l’en-tête
Authorization— exemples ci-dessous. - Les appels sont payés en dollars US sur votre solde API, et les modèles créés ainsi se téléchargent gratuitement.
claude mcp add --transport http wandy3d \ https://wandy3d.com/mcp \ --header "Authorization: Bearer hg_live_…"Remplacez hg_live_… par une clé de la plateforme API. Cursor lit ~/.cursor/mcp.json, VS Code lit .vscode/mcp.json ; tout client MCP capable d’envoyer un en-tête Authorization fonctionne.
Ce que l’assistant sait faire
generate_from_imageCréer un modèle 3D à partir d’une photo, d’un rendu ou d’un dessingenerate_from_textCréer un modèle 3D à partir d’une descriptionget_taskSuivre une génération et afficher le modèle terminélist_modelsParcourir votre bibliothèqueget_modelOuvrir l’un de vos modèlesexport_modelTélécharger en GLB, FBX, OBJ, USDZ ou STLcheck_printVérifier gratuitement un modèle pour l’impression 3D : verdict, taille imprimée, matériau, durée d’impression, réparationsmake_low_polyCréer une version Low Poly pour les jeux, l’AR et le webrig_modelAjouter à un modèle un squelette et des animations prêtes à l’emploilist_animationsLister les clips d’animation d’un modèle riggéanimate_faceAnimer le visage d’un modèle : formes d’expression et clips prêts à l’emploi — sourire, clignement des yeux, parole et plusmake_craftTransformer un modèle en papercraft, en couches pour découpe laser, en set de briques ou en jouet articuléget_creditsConsulter votre solde et les prix : crédits, ou solde API si vous vous connectez avec une clébrowse_galleryVoir des exemples de modèles dans la visionneuse 3D, sans connexionget_pricesVoir les prix actuels en crédits, sans connexion
Visionneuse 3D dans le chat
Dans les clients compatibles MCP Apps, les modèles terminés s’ouvrent dans une visionneuse interactive directement dans la conversation : rotation, passage en mode argile, ouverture dans Wandy3D. Les autres clients reçoivent une image d’aperçu et un lien.
Vous voyez le prix d’abord
Wandy3D indique à l’assistant le coût de chaque action payante, pour qu’il puisse vous demander votre accord avant de dépenser. Une génération échouée est remboursée. Les fichiers des modèles créés avec des crédits se téléchargent avec un abonnement, après un déblocage ponctuel ou contre des crédits : le prix est annoncé d’abord, pour que l’assistant puisse vous demander votre accord.
Faites votre premier appel API
Créez une clé et rechargez votre solde sur la plateforme API — cela prend une minute.
Affinage de la géométrie — Powered by Hi3D 1.0

