So verwenden Sie die Image to 3D Model API: Eine vollständige Anleitung 2026

Die Image to 3D Model API verwandelt ein einzelnes Foto in Sekundenschnelle in ein produktionsreifes 3D-Modell – ohne manuelle Modellierung. Jedes Asset von Hand zu modellieren ist langsam und teuer, und für Spielestudios, AR-Apps und E-Commerce-Teams wird es schnell zum Engpass, der Markteinführungen verzögert. Die Image-to-3D-Modell-API von Meshy beseitigt diese Reibung: Senden Sie ein Bild, lassen Sie es in Sekunden in ein 3D-Modell umwandeln und laden Sie ein vollständig texturiertes Mesh in Formaten wie GLB, FBX und OBJ herunter. Diese Anleitung führt Sie durch den gesamten Workflow – von der Erstellung Ihres API-Schlüssels bis zum Herunterladen Ihres ersten Modells – mit Copy-Paste-Code, den Sie in wenigen Minuten ausführen können.

Was ist die Image to 3D Model API?

Im Kern ist die Image to 3D Model API ein REST-Endpunkt, der von Meshy's Bild-zu-3D-Modell-KI betrieben wird. Sie senden ein einzelnes Bild (JPG, JPEG oder PNG) als öffentliche URL oder base64-String, und die API gibt ein texturiertes 3D-Modell zurück – inklusive Geometrie und Basisfarbtexturen – in Standardformaten wie GLB, FBX, OBJ, USDZ, STL und 3MF. Optionale Add-ons umfassen PBR-Karten, Texturen bis zu 4K und Multi-Winkel-Vorschaubilder.

Angetrieben von unserem neuesten Meshy 6 Modell ermöglicht Ihnen die API die Konfiguration von Topologie und Polygonanzahl, die Einstellung von Posen-Modi und die Steuerung der Texturierung mit einem Text-Prompt oder einem Referenzbild – ideal für die Generierung von Assets für Spiele, AR/VR, 3D-Druck und Produktvisualisierung.

Was brauchen Sie, um die Image to 3D API zu nutzen?

Sie brauchen nicht viel, um dieser Anleitung zu folgen. Stellen Sie sicher, dass Sie Folgendes haben:

• Ein Meshy-Konto – melden Sie sich kostenlos an falls Sie noch keins haben. Sie generieren Ihren API-Schlüssel in Schritt 1 aus dem Dashboard.

• Einen API-Schlüssel – wird verwendet, um jede Anfrage zu authentifizieren. Wir werden die Erstellung eines Schlüssels durchgehen, und Sie können den kostenlosen Testmodus-Schlüssel verwenden, um mitzumachen, ohne Credits zu verbrauchen.

• Ein Eingabebild – ein klares .jpg, .jpeg oder .png, das unter einer öffentlich zugänglichen URL gehostet wird (oder als base64 codiert). Ein sauberer Hintergrund und ein klar sichtbares Motiv liefern die besten Ergebnisse.

• Eine Möglichkeit, HTTP-Anfragen zu stellen – curl (in den folgenden Beispielen verwendet), Postman oder eine beliebige HTTP-Bibliothek in Ihrer bevorzugten Sprache. Grundlegende Vertrautheit mit REST-APIs und JSON ist hilfreich, aber nicht erforderlich.

Das ist alles – keine 3D-Modellierungserfahrung nötig. Legen wir los.

Wie man mit der API ein Bild in ein 3D-Modell umwandelt (Schritt-für-Schritt-Anleitung)

Schritt 1: Richten Sie Ihre API-Einstellungen ein

Alles, was Sie zum Entwickeln brauchen, finden Sie auf der API-Einstellungsseite. Dies ist Ihre Kommandozentrale für die Meshy-API, und sie hat drei Hauptbereiche:

• API-Schlüssel – generieren und verwalten Sie die Schlüssel, die Ihre Anfragen authentifizieren.

• Webhooks – lassen Sie sich automatisch benachrichtigen, wenn Ihre Aufgaben abgeschlossen sind.

• Nutzung – verfolgen Sie Ihr verbleibendes Credit-Guthaben und den API-Verbrauch in Echtzeit.

Gehen wir jeden Bereich durch.

Holen Sie sich Ihren API-Schlüssel

Bevor Sie Anfragen stellen, benötigen Sie einen API-Schlüssel zur sicheren Authentifizierung. Klicken Sie auf der API-Einstellungsseite auf API-Schlüssel generieren. Jeder Schlüssel folgt dem Format msy-<zufallszeichenfolge>.

Tipp: Speichern Sie Ihren API-Schlüssel nach der Generierung an einem sicheren Ort (z. B. einem Passwort-Manager oder einer Umgebungsvariable). Behandeln Sie ihn wie ein Passwort – committen Sie ihn niemals in die Versionskontrolle und legen Sie ihn nicht im clientseitigen Code offen.

Testmodus-API-Schlüssel

Während der Entwicklung und des Testens können Sie den Testmodus-API-Schlüssel verwenden, um die API zu erkunden, ohne Ihre Credits zu verbrauchen:

msy_dummy_api_key_for_test_mode_12345678

Dieser spezielle Schlüssel hat die folgenden Eigenschaften:

• Er kann verwendet werden, um Anfragen an alle Meshy-API-Endpunkte zu stellen.

• Beim Verwenden dieses Schlüssels werden keine Credits verbraucht.

• Alle gültigen Anfragen geben das gleiche Beispiel-Aufgabenergebnis zurück, unabhängig von den Eingabeparametern.

• Die Struktur der Antwortdaten stimmt exakt mit der Produktions-API überein.

Dies macht ihn perfekt zum Testen Ihrer Integration, bevor Sie zu Ihrem echten API-Schlüssel wechseln.

Webhooks einrichten (Optional)

Das Generieren eines 3D-Modells dauert eine Weile. Anstatt die API wiederholt abzufragen, um zu prüfen, ob eine Aufgabe abgeschlossen ist, können Sie sich von Meshy benachrichtigen lassen, sobald sie fertig ist. Dafür sind Webhooks da.

Fügen Sie im Bereich Webhooks der Einstellungsseite eine Endpunkt-URL hinzu, an die Meshy Ereignisbenachrichtigungen senden soll. Wenn sich der Status einer Aufgabe ändert (z. B. wenn sie abgeschlossen ist oder fehlschlägt), sendet Meshy eine HTTP POST-Anfrage an Ihre URL mit den Aufgabendetails im Payload.

Tipp: Webhooks sind der empfohlene Ansatz für die Produktion. Sie reduzieren unnötige API-Aufrufe und lassen Ihre Anwendung in Echtzeit auf Ergebnisse reagieren. Für schnelle Tests ist Polling immer noch in Ordnung. Um Webhook-Code lokal zu testen, richten Sie ihn auf eine Proxy-URL von einem Dienst wie smee.io.

Testen Sie es ohne Code – API-Playground (Optional)

Haben Sie bereits Ihren API-Schlüssel? Bevor Sie Code schreiben, können Sie eine echte Image-to-3D-Aufgabe direkt in Ihrem Browser ausführen.

Öffnen Sie meshy.ai/api-playground, wählen Sie Image to 3D im linken Panel aus und füllen Sie drei Dinge aus:

1. Authorization – fügen Sie Ihren API-Schlüssel ein (msy-xxxxxxxxxx)

2. Image – laden Sie ein .jpg, .jpeg oder .png von Ihrem Computer hoch

3. Klicken Sie auf Send

Der Playground sendet die Aufgabe und fragt automatisch nach Ergebnissen. Sobald sie abgeschlossen ist, sehen Sie die 3D-Modellvorschau und die Download-Links direkt im Browser – kein Code erforderlich.

Pro-Tipp: Das rohe Anfrage-/Antwort-Panel auf der rechten Seite zeigt genau, was die API sendet und zurückgibt. Sie können den Inhalt direkt kopieren – holen Sie sich die task_id aus der Antwort und die model_urls, sobald die Aufgabe abgeschlossen ist. Beide werden Sie in den nächsten Schritten verwenden.

Schritt 2: Senden Sie eine Image-to-3D-Aufgabe

Mit Ihrem bereiten API-Schlüssel starten Sie eine Aufgabe mit einer einzigen POST-Anfrage:

curl -X POST https://api.meshy.ai/openapi/v1/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/your-image.png"
  }'

Sie erhalten eine Antwort wie diese:

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Dieser result-Wert ist Ihre task_id – speichern Sie ihn. Sie benötigen ihn im nächsten Schritt, um den Fortschritt zu überprüfen und Ihr Modell abzurufen.

Optional: Um automatisch benachrichtigt zu werden, wenn die Aufgabe abgeschlossen ist, fügen Sie ein webhook_url-Feld zum JSON-Body hinzu – z. B. "webhook_url": "https://yourapp.com/webhooks/meshy". Siehe Schritt 3, Option B für die Funktionsweise.

Schritt 3: Holen Sie sich Ihre Ergebnisse

Ihre Aufgabe wird nicht sofort abgeschlossen – Meshy verarbeitet sie im Hintergrund. Sie haben zwei Möglichkeiten, das Ergebnis zu erhalten:

Option A: Status abfragen (Polling) (Einfachste)

Senden Sie alle 5 Sekunden eine GET-Anfrage, bis sich der status in SUCCEEDED ändert:

curl https://api.meshy.ai/openapi/v1/image-to-3d/{task_id} \
  -H "Authorization: Bearer $MESHY_API_KEY"

Die Antwort sieht so aus:

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_url": "https://assets.meshy.ai/.../model.glb",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb",
    "fbx": "https://assets.meshy.ai/.../model.fbx",
    "obj": "https://assets.meshy.ai/.../model.obj",
    "usdz": "https://assets.meshy.ai/.../model.usdz",
    "stl": "https://assets.meshy.ai/.../model.stl",
    "mtl": "https://assets.meshy.ai/.../model.mtl"
  },
  "thumbnail_url": "https://assets.meshy.ai/.../thumbnail.png",
  "consumed_credits": 30
}

Einige Felder, die wissenswert sind:

• model_urls enthält einen Download-Link für jedes generierte Format. Standardmäßig umfasst dies glb, fbx, obj, usdz, stl und mtl (die Materialdatei, die zu obj gehört).

• model_url ist eine Abkürzung zum GLB-Link – praktisch, wenn Sie nur GLB benötigen.

• consumed_credits zeigt an, wie viele Credits die Aufgabe verbraucht hat (bei fehlgeschlagenen Aufgaben ist es 0, da Credits erstattet werden).

• thumbnail_url ist immer vorhanden und zeigt auf die Vorschaubildansicht von vorne.

• thumbnail_urls erscheint nur, wenn multi_view_thumbnails: true ist, und enthält die Ansichten von vorne, rechts, hinten und links.

• alpha_thumbnail_url erscheint nur, wenn alpha_thumbnail: true ist, und enthält das Vorschaubild mit transparentem Hintergrund.

Mögliche status-Werte: PENDING → IN_PROGRESS → SUCCEEDED / FAILED / CANCELED

Option B: Webhook (Für die Produktion empfohlen)

Wenn Sie in Schritt 2 eine webhook_url festgelegt haben, sendet Meshy das abgeschlossene Aufgabenobjekt automatisch an Ihre URL – kein Polling erforderlich.

{
  "image_url": "https://example.com/your-image.png",
  "webhook_url": "https://yourapp.com/webhooks/meshy"
}

💡 Welche sollte ich verwenden? Polling ist in Ordnung für Prototyping und einmalige Aufgaben. Verwenden Sie Webhooks in der Produktion – es ist zuverlässiger und spart API-Aufrufe.

Schritt 4: Laden Sie Ihr 3D-Modell herunter

Sobald der status SUCCEEDED ist, holen Sie sich die Download-URLs aus model_urls und laden Sie das benötigte Format herunter:

curl -o model.glb "https://assets.meshy.ai/.../model.glb"

Das Flag -o model.glb speichert die Datei unter diesem Namen in Ihrem aktuellen Arbeitsverzeichnis – verwenden Sie einen vollständigen Pfad (z. B. -o /pfad/zu/model.glb), um sie woanders zu speichern.

Standardmäßig gibt jede Aufgabe GLB, FBX, OBJ, USDZ, STL und MTL (die Materialdatei für OBJ) zurück. 3MF ist optional – Sie erhalten es nur, wenn Sie es explizit über target_formats anfordern (siehe Parametertabelle unten).

⚠️ Links laufen in 3 Tagen ab (Enterprise-Pläne erhalten permanente Links). Laden Sie Ihre Modelle umgehend herunter und speichern Sie sie – die Links funktionieren nach Ablauf nicht mehr, und Sie müssen die Aufgabe erneut ausführen.

Bereit, dieses Modell in Ihrem DCC-Tool zu verwenden? Siehe die Anleitung Bridge to Blender – Meshy hat auch Bridges für Unity, Unreal, Maya und weitere.

Wie erzielt man die besten Bild-zu-3D-Ergebnisse?

• Verwenden Sie ein einzelnes, klar sichtbares Motiv. Ein Hauptobjekt, zentriert und vollständig im Bild, gibt der KI die sauberste Referenz – vermeiden Sie überladene Szenen, starke Beschnitte und extreme Winkel.

• Bevorzugen Sie einen sauberen, aufgeräumten Hintergrund. Einfarbige oder einfache Hintergründe helfen dem Modell, das Motiv von seiner Umgebung zu trennen.

• Verwenden Sie gleichmäßiges, diffuses Licht. Harte Schatten und starke Glanzlichter können irreführende Details in die generierte Textur einbrennen.

• Beginnen Sie mit einem hochauflösenden, scharfen Bild. Mehr Details am Anfang ergeben mehr Details am Ende – unscharfe oder niedrig aufgelöste Eingaben erzeugen weichere Modelle.

Welche Programmiersprachen kann ich mit der Image to 3D API verwenden?

Jede Sprache, die HTTP-Anfragen stellen kann – Sie senden ein POST mit JSON und fragen mit GET ab. Gängige Optionen:

• Python – verwenden Sie die Bibliothek requests oder httpx

• JavaScript / TypeScript – verwenden Sie fetch (integriert) oder axios

• Go – verwenden Sie net/http aus der Standardbibliothek

• cURL – großartig für schnelle Tests im Terminal

Sie finden auch fertig zu kopierende Codebeispiele für alle vier im API-Playground.

Wie viele Credits kostet eine Image-to-3D-Aufgabe?

Die Kosten hängen von der Modellversion ab und davon, ob Sie Texturen generieren. Die Standardkonfiguration (meshy-6 mit Texturierung) kostet 30 Credits pro Aufgabe:

Fehlgeschlagene Aufgaben werden automatisch erstattet – consumed_credits gibt 0 zurück. Überprüfen Sie immer die Preise für die aktuellen Tarife.

Welche Parameter akzeptiert die Image to 3D API?

Senden Sie ein POST an /openapi/v1/image-to-3d mit diesen Parametern: Erforderlich (einer von):

Optional:

Nächste Schritte mit der Image to 3D API

Sie haben jetzt den vollständigen Workflow: Erstellen Sie einen API-Schlüssel, senden Sie ein Bild, fragen Sie das Ergebnis ab oder verwenden Sie einen Webhook, und laden Sie dann Ihr Modell herunter. Dieselben vier Schritte skalieren von einem schnellen Prototypen bis zu einer Produktionspipeline, die Tausende von Bildern automatisch in 3D-Assets verwandelt. Holen Sie sich Ihren Schlüssel von der API-Einstellungsseite und bringen Sie noch heute Ihr erstes Modell auf den Markt. Bevorzugen Sie einen Start mit einem Prompt anstelle eines Fotos? Verwenden Sie die Text to 3D Model API.

Häufig gestellte Fragen

Wie konvertiere ich ein Bild über die API in ein 3D-Modell?

Senden Sie eine POST-Anfrage an /openapi/v1/image-to-3d mit Ihrer image_url und Ihrem API-Schlüssel, fragen Sie dann die Aufgabe ab (oder verwenden Sie einen Webhook), bis ihr status SUCCEEDED ist. Die Antwort enthält Download-Links für das generierte Modell. Der vollständige Vier-Schritte-Ablauf – Schlüssel, Senden, Abrufen, Herunterladen – wird in der Schritt-für-Schritt-Anleitung oben behandelt.

Welche Ausgabeformate (STL, GLB, OBJ) unterstützt die API?

Jede Aufgabe gibt standardmäßig GLB, FBX, OBJ, USDZ, STL und MTL zurück, wobei 3MF auf Anfrage über target_formats verfügbar ist. GLB ist am besten für Web und AR, FBX und OBJ für DCC-Tools und Spiel-Engines, USDZ für iOS AR und STL für den 3D-Druck geeignet.

Welche Bildformate kann ich hochladen?

Die Image to 3D API unterstützt JPG-, JPEG- und PNG-Bilder bis zu 100 MB – größer als das 20-MB-Limit in der Meshy Workspace-Benutzeroberfläche. Für die genauesten Ergebnisse verwenden Sie ein PNG mit transparentem oder sauberem weißem Hintergrund, was der API hilft, das Motiv zu isolieren und ein qualitativ hochwertigeres 3D-Modell zu generieren.

Kann ich ein texturiertes 3D-Modell von der API erhalten?

Ja. Die Texturierung ist standardmäßig aktiviert ("should_texture": true). Um PBR-Karten (Metallic, Roughness, Normal) hinzuzufügen, setzen Sie "enable_pbr": true – bei meshy-6/latest ist dann auch eine Emissionskarte enthalten. Für eine 4K-Basisfarbtextur setzen Sie "hd_texture": true (nur auf meshy-6/latest unterstützt; PBR-Karten bleiben bei 2K). Sie können den Texturstil auch mit einem texture_prompt oder einer texture_image_url steuern.

Kann ich ein für den 3D-Druck bereites 3D-Modell (STL) generieren?

Ja – STL wird standardmäßig generiert, daher benötigt eine Bild-zu-3D-STL-Konvertierung keine zusätzlichen Parameter: Greifen Sie einfach auf model_urls.stl zu, wenn die Aufgabe abgeschlossen ist. Das macht Bild-zu-3D-Druck-Workflows einfach, da STL das Standardformat ist, das Slicer erwarten. Wenn Sie nur STL möchten, setzen Sie "target_formats": ["stl"], um die anderen Formate zu überspringen und die Generierungszeit zu verkürzen.

Welche Pläne beinhalten API-Zugriff?

Der API-Zugriff ist in den Pro-, Studio- und Enterprise-Plänen verfügbar – es ist eine Funktion ab Pro. Der kostenlose Starter-Plan beinhaltet keinen API-Zugriff. Siehe Preise für Details.

Wie lange sind Download-Links gültig?

Download-Links sind in den Pro- und Studio-Plänen 3 Tage gültig. Enterprise-Kunden erhalten permanente Links. Speichern Sie Ihre Dateien umgehend – abgelaufene Links können nicht wiederhergestellt werden, und Sie müssen die Aufgabe erneut ausführen.

Kann ich mehrere Aufgaben gleichzeitig ausführen?

Ja, gleichzeitige Anfragen werden unterstützt. Wenn Sie einen 429 Too Many Requests-Fehler erhalten, hat Ihr Konto sein Ratengrenze erreicht – implementieren Sie exponentielles Backoff und wiederholen Sie den Vorgang. Siehe die Seite Ratenbegrenzungen für die Grenzen Ihres Plans.

Die Aufgabe zeigt FAILED – was soll ich tun?

Überprüfen Sie task_error.message auf die Ursache. Häufige Ursachen:

Wenn das Problem weiterhin besteht, kontaktieren Sie den Meshy-Support.