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

    Generierung starten

    POST/generate/cloud/ultra

    Schick ein Foto als Multipart-Feld file. Die Antwort enthält eine task_id.

  3. 3

    Task abfragen

    GET/task/{task_id}/status

    Alle paar Sekunden, bis status den Wert done hat; dann enthält die Antwort die model_id.

  4. 4

    Herunterladen

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

    Bei 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": "…"}}
Statusdetail.errorBedeutung
400invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_imageDie 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.
401invalid_api_keyDer Key fehlt, ist falsch oder widerrufen.
402insufficient_balancemonthly_limit_reachedkey_limit_reachedNicht genug API-Guthaben oder ein Monatslimit (Konto oder Key) ist erreicht.
403subscription_requiredsession_requiredErfordert eine Anmeldung auf der Website oder einen Tarif, um ein auf der Website erstelltes Modell herunterzuladen.
404feature_offNicht gefunden oder für dich noch nicht verfügbar.
409file_not_readyDie Modelldatei ist noch nicht fertig.
409idempotency_key_reusedidempotency_in_progressDer Idempotency-Key wurde schon mit einer anderen Anfrage verwendet, oder seine erste Anfrage läuft noch.
429rate_limitedtoo_many_jobsRate-Limit erreicht oder zu viele Generierungen gleichzeitig aktiv.

Preise

Was ein Modell kostet, in US-Dollar, laut aktueller API-Preisliste.

API-Preis pro generiertem Modell, in US-Dollar
VersionEin Foto2–4 Ansichten
Wandy 1/generate/cloud/fast0,09 $0,24 $
Wandy 1.1/generate/cloud0,15 $0,27 $
Wandy 2/generate/cloud/ultra0,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.

API-Preise ansehen

Endpunkte

Die öffentliche API in einer Tabelle. Jede Route nutzt denselben Bearer-Key.

Generieren

MethodePfadFunktion
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

MethodePfadFunktion
GET/task/{task_id}/status
Fortschritt einer Generierung
GET/api/generate/eta
Wie lange eine Generierung gerade dauert

Bibliothek

MethodePfadFunktion
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

MethodePfadFunktion
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

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

Webhook-Secrets und ein Test-Event
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/mcp

Mit 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

  1. Füge in den Connector-Einstellungen der App einen eigenen Connector mit der Server-URL oben hinzu.
  2. Melde dich mit Wandy3D an, wenn die App danach fragt, und erlaube die Verbindung.
  3. 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

  1. Erstelle einen Schlüssel auf der API-Plattform und lade dein API-Guthaben auf.
  2. Füge den Server mit dem Schlüssel im Authorization-Header hinzu — Beispiele unten.
  3. 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 erstellen
  • generate_from_textEin 3D-Modell aus einer Beschreibung erstellen
  • get_taskEine Generierung verfolgen und das fertige Modell zeigen
  • list_modelsDeine Bibliothek durchsuchen
  • get_modelEines deiner Modelle öffnen
  • export_modelGLB, FBX, OBJ, USDZ oder STL herunterladen
  • check_printEin Modell kostenlos für den 3D-Druck prüfen: Ergebnis, Druckgröße, Material, Druckzeit, Reparaturen
  • make_low_polyEine Low-Poly-Version für Spiele, AR und das Web erstellen
  • rig_modelEin Modell mit Skelett und fertigen Animationen riggen
  • list_animationsDie Animationsclips eines geriggten Modells auflisten
  • animate_faceDas Gesicht eines Modells animieren: Mimik-Shapes und fertige Clips — Lächeln, Blinzeln, Sprechen und mehr
  • make_craftEin Modell in ein Papiermodell, Laserschichten, ein Klemmbaustein-Set oder eine Flexi-Figur verwandeln
  • get_creditsGuthaben und Preise prüfen: Credits oder dein API-Guthaben, wenn du per Schlüssel verbindest
  • browse_galleryBeispielmodelle im 3D-Viewer ansehen, ohne Anmeldung
  • get_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.

API-Schlüssel holen

Geometrie-Verfeinerung — Powered by Hi3D 1.0