Wandy3D API
Erstelle 3D-Modelle aus deinem Code, deiner Engine oder deinem KI-Agenten
Schick ein Foto, ein paar Ansichten oder einen Satz und erhalte ein texturiertes 3D-Modell – dann exportierst du es, druckst es, remeshst es in Quads, riggst es oder bereitest es für deine Game-Engine vor. Dieselbe Pipeline wie im Studio, über ganz normales HTTPS.
Ab 0,09 $ pro Modell (Wandy 1) · Wandy 2 0,18 $
2,00 $ gratis zum Testen — etwa 11 Modelle mit Wandy 2 oder 22 Modelle mit Wandy 1 mit deinem ersten API-Schlüssel.
- Vorausbezahltes Guthaben, das nie verfällt · kein Abo
- Authentifizierung per Bearer-Key
- 60 Anfragen pro Minute und Key
- REST und JSON über 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>"}, …}Quickstart
Vier Schritte vom Foto zur GLB-Datei.
- 1
Key erstellen
In der API-Plattform unter API-Keys, danach lädst du dein API-Guthaben auf. Der Key wird nur einmal angezeigt – speichere ihn in einer Umgebungsvariable wie
WANDY3D_API_KEY. - 2
Generierung starten
POST
/generate/cloud/ultraSchick ein Foto als Multipart-Feld
file. Die Antwort enthält einetask_id. - 3
Task abfragen
GET
/task/{task_id}/statusAlle paar Sekunden, bis
statusden Wertdonehat; dann enthält die Antwort diemodel_id. - 4
Herunterladen
GET
/model/{model_id}/export?format=glbBei GLB kommt sofort eine Antwort mit einem kurzlebigen Link. Andere Formate werden erst konvertiert – frag dieselbe URL ab, bis die Datei bereit ist.
# 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>"Keys und Limits
Jede Anfrage enthält deinen Key im Authorization-Header.
Authorization: Bearer hg_live_…Halte Keys geheim
Ein Key handelt in deinem Namen und verbraucht dein API-Guthaben. Nutz ihn auf deinem Server, in Skripten oder in CI – niemals auf einer Webseite oder in einer mobilen App. Einen geleakten Key widerrufst du in der API-Plattform: Er funktioniert sofort nicht mehr.
Rate-Limit
60 Anfragen pro Minute und Key. Über dem Limit lautet die Antwort 429 mit retry_after – den Sekunden, die du warten musst.
Bis zu 10 Keys
Nutz einen pro App oder Rechner, damit du einen widerrufen kannst, ohne die anderen anzufassen.
Fehler
Fehler kommen als JSON. Die meisten enthalten einen festen Code in detail.error:
{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}| Status | detail.error | Bedeutung |
|---|---|---|
| 400 | invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_image | Die Anfrage ist so nicht verwendbar: ein Bildlink, den wir nicht herunterladen können, ein ungültiger Parameter oder eine ungültige Callback-URL. Es wird nichts berechnet. |
| 401 | invalid_api_key | Der Key fehlt, ist falsch oder widerrufen. |
| 402 | insufficient_balancemonthly_limit_reachedkey_limit_reached | Nicht genug API-Guthaben oder ein Monatslimit (Konto oder Key) ist erreicht. |
| 403 | subscription_requiredsession_required | Erfordert eine Anmeldung auf der Website oder einen Tarif, um ein auf der Website erstelltes Modell herunterzuladen. |
| 404 | feature_off | Nicht gefunden oder für dich noch nicht verfügbar. |
| 409 | file_not_ready | Die Modelldatei ist noch nicht fertig. |
| 409 | idempotency_key_reusedidempotency_in_progress | Der Idempotency-Key wurde schon mit einer anderen Anfrage verwendet, oder seine erste Anfrage läuft noch. |
| 429 | rate_limitedtoo_many_jobs | Rate-Limit erreicht oder zu viele Generierungen gleichzeitig aktiv. |
Preise
Was ein Modell kostet, in US-Dollar, laut aktueller API-Preisliste.
| Version | Ein Foto | 2–4 Ansichten |
|---|---|---|
Wandy 1/generate/cloud/fast | 0,09 $ | 0,24 $ |
Wandy 1.1/generate/cloud | 0,15 $ | 0,27 $ |
Wandy 2/generate/cloud/ultra | 0,18 $ | 0,30 $ |
Jeder kostenpflichtige Aufruf wird in US-Dollar von deinem vorausbezahlten API-Guthaben abgebucht. Lade per Karte ab $5 auf – das Guthaben verfällt nie, und fehlgeschlagene Jobs werden automatisch erstattet.
Modelle, die du über die API erstellst, kannst du kostenlos in jedem Format herunterladen.
Neue Konten mit Anmeldung über Google oder Apple bekommen 2,00 $ auf ihren ersten API-Schlüssel — einmalig, ohne Karte.
Endpunkte
Die öffentliche API in einer Tabelle. Jede Route nutzt denselben Bearer-Key.
Generieren
| Methode | Pfad | Funktion |
|---|---|---|
| POST | /generate/cloud/ultra | Modell aus einem Foto, Wandy 2Kostenpflichtig |
| POST | /generate/cloud | Modell aus einem Foto, Wandy 1.1Kostenpflichtig |
| POST | /generate/cloud/fast | Modell aus einem Foto, Wandy 1Kostenpflichtig |
| POST | /generate/cloud/multi/ultra | Modell aus 2–4 Ansichten, Wandy 2Kostenpflichtig |
| POST | /generate/cloud/multi | Modell aus 2–4 Ansichten eines Objekts, Wandy 1.1Kostenpflichtig |
| POST | /generate/cloud/multi/fast | Modell aus 2–4 Ansichten, Wandy 1Kostenpflichtig |
| POST | /generate/text/imagine | Text-Prompt → KonzeptbildKostenpflichtig |
| POST | /generate/text | Konzeptbild → 3D-ModellKostenpflichtig |
| POST | /generate/retexture | Neue Textur für ein Modell aus einem FotoKostenpflichtig |
Tasks
| Methode | Pfad | Funktion |
|---|---|---|
| GET | /task/{task_id}/status | Fortschritt einer Generierung |
| GET | /api/generate/eta | Wie lange eine Generierung gerade dauert |
Bibliothek
| Methode | Pfad | Funktion |
|---|---|---|
| GET | /library | Deine Modelle, neueste zuerst |
| GET | /model/{model_id} | Ein Modell, sein GLB-Link und was es darstellt |
| DELETE | /model/{model_id} | Modell löschen |
| GET | /model/{model_id}/versions | Alle Versionen eines Modells und die daraus erstellten Dateien |
Downloads und Nachbearbeitung
| Methode | Pfad | Funktion |
|---|---|---|
| GET | /model/{model_id}/stream | Die GLB-Datei des ModellsDownload |
| GET | /model/{model_id}/export | Als GLB, FBX, OBJ, USDZ, STL oder Draco GLB herunterladenDownload |
| GET | /model/{model_id}/print | Druckfertige STL oder 3MF mit DruckprüfberichtDownload |
| GET | /model/{model_id}/retopo | Quad-Remesh oder Low Poly mit gebackenen TexturenKostenpflichtigDownload |
| GET | /model/{model_id}/rig | Auto-Rig mit AnimationsclipsKostenpflichtig |
| GET | /model/{model_id}/parts | Ein Modell in Teile zerlegenKostenpflichtig |
| GET | /model/{model_id}/gamepack | Spielfertiges Paket mit LODs und CollidernKostenpflichtigDownload |
| GET | /model/{model_id}/make/{kind} | Bastelvorlagen, zum Beispiel PapiermodelleKostenpflichtig |
| GET | /model/{model_id}/outputs/{output_id} | Eine früher erstellte Datei erneut öffnen |
| GET | /model/{model_id}/rig/suggest | Welches Rig passt — kostenlos, bevor du zahlst |
Konto
| Methode | Pfad | Funktion |
|---|---|---|
| GET | /api/platform/balance | Dein API-Guthaben |
| GET | /api/platform/prices | Die aktuelle Preisliste |
Alle Antworten und Fehler jeder Operation sind im OpenAPI-Dokument typisiert, mit Beispielen. Generiere daraus einen Client oder gib es deinem Coding-Agenten.
Links und Wiederholungen
Sende einen Link statt eine Datei hochzuladen, und wiederhole eine Anfrage, ohne doppelt zu zahlen.
Ein Foto per Link
Jede Foto-Route akzeptiert auch JSON mit image_url; für mehrere Ansichten image_urls. Wir laden das Bild herunter und behandeln es genau wie einen Upload. Der Link muss https auf eine öffentliche Adresse sein und die Datei ein JPEG, PNG oder WebP bis 20 MB. Bei einem unbrauchbaren Link kommt 400 zurück, bevor etwas berechnet wird.
# 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://."}}Sichere Wiederholungen
Füge einem kostenpflichtigen POST einen Idempotency-Key-Header hinzu. Kommt dieselbe Anfrage innerhalb von 24 Stunden erneut an — ein Timeout, ein Retry aus deiner Queue —, bekommst du die erste Antwort mit derselben task_id, und nichts wird ein zweites Mal gestartet oder berechnet. Derselbe Schlüssel mit einer anderen Anfrage liefert 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
Spar dir das Polling: Füge beim Start einer Generierung callback_url hinzu, und wir senden per POST ein signiertes Event an deinen Server, sobald sie fertig ist.
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.Events
task.completed — das Modell ist fertig, mit ID, Name und Links zum Modell und zu seinem GLB-Export. task.failed — der Job ist fehlgeschlagen, und die Kosten sind wieder auf deinem API-Guthaben. ping — ein Test, den du aus dem Dashboard sendest.
Signiert
Jedes Event enthält Wandy-Signature: t=…,v1=… — v1 ist der HMAC-SHA256 aus Zeitstempel, einem Punkt und dem rohen Body, verschlüsselt mit dem Webhook-Secret des API-Schlüssels, der den Job gestartet hat. Lehne Events ab, die älter als 5 Minuten sind.
Wiederholt
Antworte innerhalb von 10 Sekunden mit einem beliebigen 2xx. Alles andere wird 3-mal wiederholt — nach 30 s, 2 min und 10 min — mit derselben Event-ID, sodass sich Duplikate leicht verwerfen lassen.
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);Mit KI-Agenten nutzen
Verbinde Wandy3D mit Claude, ChatGPT, Cursor, VS Code oder jeder App, die MCP unterstützt. Bitte einfach in normalen Worten um ein 3D-Modell: Der Assistent erstellt es in deinem Wandy3D-Konto und zeigt es direkt im Chat.
Server-URL
https://wandy3d.com/mcpMit einem Klick zum Editor hinzufügen
Der Editor öffnet sich und fragt nach, bevor er den Server hinzufügt. Beispielmodelle ansehen und Preise abrufen funktioniert sofort. Zum Generieren füge zuerst deinen API-Schlüssel ein: Die Buttons übertragen ihn in die Einstellungen des Editors.
Der Schlüssel bleibt in deinem Browser: Er landet nur im Link, der deinen Editor öffnet.
Zwei Wege zur Verbindung
Mit Wandy3D anmelden
Claude, ChatGPT und andere Chat-Apps mit Connectors
- Füge in den Connector-Einstellungen der App einen eigenen Connector mit der Server-URL oben hinzu.
- Melde dich mit Wandy3D an, wenn die App danach fragt, und erlaube die Verbindung.
- Bitte um ein Modell. Es wird mit deinen Wandy3D-Credits zu Website-Preisen erstellt.
API-Schlüssel nutzen
Claude Code, Cursor, VS Code und deine eigenen Skripte
- Erstelle einen Schlüssel auf der API-Plattform und lade dein API-Guthaben auf.
- Füge den Server mit dem Schlüssel im
Authorization-Header hinzu — Beispiele unten. - Aufrufe werden in US-Dollar über dein API-Guthaben bezahlt, und so erstellte Modelle lädst du kostenlos herunter.
claude mcp add --transport http wandy3d \ https://wandy3d.com/mcp \ --header "Authorization: Bearer hg_live_…"Ersetze hg_live_… durch einen Schlüssel von der API-Plattform. Cursor liest ~/.cursor/mcp.json, VS Code liest .vscode/mcp.json; jeder MCP-Client, der einen Authorization-Header senden kann, funktioniert.
Was der Assistent kann
generate_from_imageEin 3D-Modell aus einem Foto, Render oder einer Zeichnung erstellengenerate_from_textEin 3D-Modell aus einer Beschreibung erstellenget_taskEine Generierung verfolgen und das fertige Modell zeigenlist_modelsDeine Bibliothek durchsuchenget_modelEines deiner Modelle öffnenexport_modelGLB, FBX, OBJ, USDZ oder STL herunterladencheck_printEin Modell kostenlos für den 3D-Druck prüfen: Ergebnis, Druckgröße, Material, Druckzeit, Reparaturenmake_low_polyEine Low-Poly-Version für Spiele, AR und das Web erstellenrig_modelEin Modell mit Skelett und fertigen Animationen riggenlist_animationsDie Animationsclips eines geriggten Modells auflistenanimate_faceDas Gesicht eines Modells animieren: Mimik-Shapes und fertige Clips — Lächeln, Blinzeln, Sprechen und mehrmake_craftEin Modell in ein Papiermodell, Laserschichten, ein Klemmbaustein-Set oder eine Flexi-Figur verwandelnget_creditsGuthaben und Preise prüfen: Credits oder dein API-Guthaben, wenn du per Schlüssel verbindestbrowse_galleryBeispielmodelle im 3D-Viewer ansehen, ohne Anmeldungget_pricesAktuelle Preise in Credits ansehen, ohne Anmeldung
3D-Viewer im Chat
In Clients mit Unterstützung für MCP Apps öffnen sich fertige Modelle in einem interaktiven Viewer direkt im Gespräch: drehen, zur Clay-Ansicht wechseln, in Wandy3D öffnen. Andere Clients bekommen ein Vorschaubild und einen Link.
Du siehst den Preis vorher
Wandy3D nennt dem Assistenten die Kosten jeder kostenpflichtigen Aktion, damit er vor dem Ausgeben bei dir nachfragen kann. Eine fehlgeschlagene Generierung wird erstattet. Dateien von Modellen, die mit Credits erstellt wurden, lädst du mit einem Abo, nach einer einmaligen Freischaltung oder für Credits herunter: Der Preis wird vorher genannt, damit der Assistent bei dir nachfragen kann.
Starte deinen ersten API-Aufruf
Erstelle einen Schlüssel und lade Guthaben auf der API-Plattform auf — das dauert nur eine Minute.
Geometrie-Verfeinerung — Powered by Hi3D 1.0

