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. 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. 2

    Lancez une génération

    POST/generate/cloud/ultra

    Envoyez une photo dans le champ multipart file. La réponse contient un task_id.

  3. 3

    Interrogez la tâche

    GET/task/{task_id}/status

    Toutes les quelques secondes, jusqu’à ce que status vaille done ; la réponse contient alors le model_id.

  4. 4

    Téléchargez

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

    Le 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": "…"}}
Statutdetail.errorSignification
400invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_imageLa 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é.
401invalid_api_keyLa clé est absente, incorrecte ou révoquée.
402insufficient_balancemonthly_limit_reachedkey_limit_reachedSolde API insuffisant, ou limite mensuelle (du compte ou de la clé) atteinte.
403subscription_requiredsession_requiredNécessite une session connectée sur le site, ou une formule pour télécharger un modèle créé sur le site.
404feature_offIntrouvable, ou pas encore accessible pour vous.
409file_not_readyLe fichier du modèle n’est pas encore prêt.
409idempotency_key_reusedidempotency_in_progressCette Idempotency-Key a déjà été utilisée avec une autre requête, ou sa première requête est encore en cours.
429rate_limitedtoo_many_jobsLimite 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.

Prix API par modèle généré, en dollars US
VersionUne photo2–4 vues
Wandy 1/generate/cloud/fast0,09 $US0,24 $US
Wandy 1.1/generate/cloud0,15 $US0,27 $US
Wandy 2/generate/cloud/ultra0,18 $US0,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.

Voir les tarifs de l’API

Endpoints

L’API publique en un seul tableau. Chaque route accepte la même clé Bearer.

Génération

MéthodeCheminDescription
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éthodeCheminDescription
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éthodeCheminDescription
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éthodeCheminDescription
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éthodeCheminDescription
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.

Secrets webhook et événement de test
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/mcp

Ajoutez-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

  1. Dans les paramètres des connecteurs de l’app, ajoutez un connecteur personnalisé avec l’URL du serveur ci-dessus.
  2. Connectez-vous avec Wandy3D lorsque l’app vous le demande, puis autorisez la connexion.
  3. 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

  1. Créez une clé sur la plateforme API et rechargez votre solde API.
  2. Ajoutez le serveur avec la clé dans l’en-tête Authorization — exemples ci-dessous.
  3. 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 dessin
  • generate_from_textCréer un modèle 3D à partir d’une description
  • get_taskSuivre une génération et afficher le modèle terminé
  • list_modelsParcourir votre bibliothèque
  • get_modelOuvrir l’un de vos modèles
  • export_modelTélécharger en GLB, FBX, OBJ, USDZ ou STL
  • check_printVérifier gratuitement un modèle pour l’impression 3D : verdict, taille imprimée, matériau, durée d’impression, réparations
  • make_low_polyCréer une version Low Poly pour les jeux, l’AR et le web
  • rig_modelAjouter à un modèle un squelette et des animations prêtes à l’emploi
  • list_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 plus
  • make_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 connexion
  • get_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.

Obtenir une clé API

Affinage de la géométrie — Powered by Hi3D 1.0