lowpoly wird am 30.10.2026 abgeschaltet. meshy-7 wird als 3D-Generierungsmodell am 31.12.2026 abgeschaltet; als Texturmodell bleibt es verfügbar. Wechseln Sie vor diesen Terminen das Modell, um Fehler bei Anfragen zu vermeiden. Alle Abkündigungen ansehen

Lebenszyklus einer Aufgabe

Erfahren Sie, wie eine Aufgabe von der Anfrage zum Ergebnis gelangt, wie lange das üblicherweise dauert und wie lange Ihr Code darauf warten sollte.


Wie eine Aufgabe abläuft

Eine Erstellungsanfrage gibt eine Aufgaben-ID zurück, ohne darauf zu warten, dass die Aufgabe ausgeführt wird. Die Aufgabe läuft dann im Hintergrund, und Sie verfolgen sie auf eine von drei Arten: Sie fragen ihren GET-Endpunkt ab, öffnen ihren Stream-Endpunkt oder erhalten einen Webhook.

Eine Erstellungsanfrage startet eine Aufgabe mit dem Status PENDING. Ein Worker übernimmt sie, und sie wechselt zu IN_PROGRESS, wo sie die meiste Zeit verbringt. Sie endet mit SUCCEEDED oder FAILED, und ein finaler Status ändert sich nie wieder.
Erstellungsanfrage
PENDING
Wartet in der Warteschlange
IN_PROGRESS
Generiert das Ergebnis
SUCCEEDED
Ergebnis herunterladen
FAILED
Credits erstattet

Die Aufgabe erfasst jeden Schritt in ihren Feldern created_at, started_at und finished_at.

Die folgende Tabelle zeigt, was Ihr Code bei jedem Status tun sollte.

StatusWas Ihr Code tun sollte
PENDINGWeiter warten.
IN_PROGRESSprogress verfolgen: den Prozentsatz der erledigten Arbeit, von 0 bis 100.
SUCCEEDEDErgebnis herunterladen. Meshy bewahrt die Dateien für eine begrenzte Zeit auf. Siehe Aufbewahrung von Assets.
FAILEDtask_error auslesen, dann die Eingabe korrigieren oder eine neue Aufgabe erstellen. Siehe Fehler.
CANCELEDNicht mehr warten. Die Aufgabe liefert kein Ergebnis. Nur Creative-Lab-Aufgaben verwenden diesen Status.

SUCCEEDED, FAILED und CANCELED sind final. Sobald eine Aufgabe einen dieser Status erreicht, ändert sich ihr Status nie wieder.

Aus Sicht Ihres Codes sieht das so aus:

Erstellen Sie eine Aufgabe und fragen Sie sie dann ab, bis sie abgeschlossen ist.
  1. Anfrage: POST/image-to-3d

  2. Antwort: 202{ "result": "<task_id>" }Aufgabe erstellt

  3. Alle paar Sekunden wiederholen
    1. Anfrage: GET/image-to-3d/<task_id>

    2. Antwort: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. Anfrage: GET/image-to-3d/<task_id>

  5. Antwort: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Wenn Ihre App aufhört zu warten, läuft die Aufgabe weiter. Rufen Sie sie später mit derselben Aufgaben-ID per GET ab.

Verarbeitungszeiten

Die folgenden Tabellen zeigen die Medianzeiten für produktiven API-Traffic im September 2026.

Eine Zeitspanne läuft von der Erstellung der Aufgabe bis zum finalen Status. Fast die gesamte Zeit entfällt auf die Verarbeitung, da eine Aufgabe in der Regel nur wenige Sekunden im Status PENDING verbleibt. Wenn die Warteschlange ausgelastet ist, können Aufgaben länger warten, bevor sie starten, und Aufgaben auf Plänen mit einer höheren Priorität starten in der Regel früher.

Zeiten unter 2 Minuten sind in Sekunden (s) angegeben, längere Zeiten in Minuten (min). „Nicht unterstützt“ bedeutet, dass die API diese Option mit diesem Modell nicht anbietet.

3D-Generierung

APIKonfigurationmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Text zu 3D (Preview)Nur Netz75 s90 s45 s10 s
Bild zu 3DNur Netz75 s90 s40 s4 s
Netz mit 2K-Texturen2 min3 min75 s60 s
Netz mit 4K-Texturen2,5 min3,5 minNicht unterstützt80 s
Netz mit 8K-Texturen3,5 min4 minNicht unterstützt2,5 min
Multi-Bild zu 3DNur Netz65 s2 min30 sNicht unterstützt
Netz mit 2K-Texturen2,5 min3,5 min85 sNicht unterstützt
Netz mit 4K-Texturen3 min4 minNicht unterstütztNicht unterstützt
Netz mit 8K-Texturen3,5 min4,5 minNicht unterstütztNicht unterstützt

Bei Bild zu 3D und Multi-Bild zu 3D bedeutet „Nur Netz“ should_texture: false. Diese Optionen und Eingaben verändern die Zeit:

  • PBR-Texturen (enable_pbr) fügen 30 bis 60 Sekunden hinzu.
  • Ultra-Geometrie (geometry_resolution: "2k" oder "4k") fügt bis zu 1 Minute hinzu.
  • Bei gleichen Einstellungen dauern komplexere Eingabebilder länger.

Texturierung

APITexturauflösungTypische Zeit
Text zu 3D (Refine)2K oder 4K80 s
8K3,5 min
Neutexturierung2K55 s
4K90 s
8K2,5 min

Bildgenerierung

APInano-banananano-banana-2nano-banana-proGPT-Image-Modelle
Text zu Bild20 s15 s25 s20 bis 35 s
Bild zu Bild40 s20 s30 s20 bis 40 s

Rigging und Animation

APIKonfigurationTypische Zeit
Auto-RiggingAutomatisches Rigging40 s
AnimationPro Anfrage15 s
Text to Motionprime-mode15 s
swift-mode10 s

Nachbearbeitung

3D-Druck

APIKonfigurationTypische Zeit
Druckbarkeit analysierenNur Netzprüfungen1 s
Netz- und Dünnwandprüfungen10 s
Multi-ColorPro Anfrage30 s
Druckbarkeit reparierenNur Netzreparatur10 s
Dünnwandprüfung, Wände beibehalten20 s
Dünnwandprüfung, Wände verdickt100 s
Auto SplitEinfarbige Teile70 s
Texturierte Teile (keep_texture: true)170 s

Bei v2 führen Druckbarkeit reparieren und Druckbarkeit analysieren die Dünnwandprüfung immer aus. Bei v1 führen sie diese aus, wenn Sie einen Druckertyp oder eine Druckgröße angeben.


Wie lange warten

Die Aufgabe läuft weiter, auch wenn Ihr Code aufhört zu warten. Wenn Ihre Anfrage ein timeout erreicht, Ihre Verbindung abbricht oder Ihr Stream geschlossen wird, schlägt die Aufgabe nicht fehl und wird nicht abgebrochen.

  • Warten Sie mindestens 60 Minuten, gerechnet ab created_at der Aufgabe, bevor Sie aufhören zu warten. Wenn Sie früher aufhören, verpassen Sie möglicherweise eine Aufgabe, die später erfolgreich abgeschlossen wird. Dies kommt vor allem in Zeiten hoher Auslastung vor.
  • Bewahren Sie die Aufgaben-ID auf. Sie können die Aufgabe jederzeit erneut abrufen. Ist sie nach 60 Minuten immer noch nicht final, prüfen Sie sie später erneut. Bleibt das so, wenden Sie sich an den Support.
  • Nur FAILED bedeutet, dass die Aufgabe fehlgeschlagen ist. Meshy erstattet fehlgeschlagene Aufgaben automatisch.

Verwenden Sie diese Werte in Ihrem Code:

EinstellungEmpfohlener Wert
Timeout für Erstellungsanfrage (POST)60 Sekunden
Timeout für Erstellungsanfrage (POST) mit einer model_url-Datei über 100 MB120 Sekunden. Meshy lädt die Datei herunter, bevor es antwortet.
Timeout für Statusanfrage (GET)30 Sekunden
AbfrageintervallDer Retry-After-Header, oder 5 Sekunden, falls dieser fehlt. Abfragen zählen zu Ihrer Ratenbegrenzung.
Fehlgeschlagene Statusanfrage (timeout, 429 oder 5xx)Versuchen Sie es bei der nächsten Abfrage erneut. Das bedeutet nicht, dass die Aufgabe fehlgeschlagen ist.
Gesamtwartezeit pro AufgabeMindestens 60 Minuten ab created_at. Setzen Sie diesen Zähler nicht zurück, wenn Sie einen Stream erneut verbinden.
StreamEin Stream kann sich schließen, bevor die Aufgabe abgeschlossen ist. Schließt er ohne finalen Status, stellen Sie die Verbindung erneut her oder wechseln Sie zum Polling.

Verwenden Sie für viele Aufgaben gleichzeitig Webhooks anstelle von Polling für jede einzelne. Ist das finale Ereignis einer Aufgabe nach etwa dem Doppelten ihrer typischen Zeit noch nicht eingetroffen, rufen Sie die Aufgabe über ihren GET-Endpunkt ab.