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 Task-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: Abfragen des GET-Endpunkts, Öffnen des Stream-Endpunkts oder Empfangen eines Webhooks.

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.

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

Aus Sicht Ihres Codes sieht das so aus:

Verarbeitungszeiten

Die folgenden Tabellen zeigen Median-Zeiten für den Produktions-API-Verkehr im September 2026.

Eine Zeit läuft von der Aufgabenerstellung bis zum finalen Status. Fast die gesamte Zeit entfällt auf die Verarbeitung, da eine Aufgabe meist 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 höherer 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

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

Bildgenerierung

Rigging und Animation

Nachbearbeitung

3D-Druck

Bei v2 führen Druckbarkeit reparieren und Druckbarkeit analysieren immer die Dünnwandprüfung aus. Bei v1 wird sie ausgeführt, 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 schließt, schlägt die Aufgabe dadurch nicht fehl und wird nicht abgebrochen.

• Warten Sie mindestens 60 Minuten, gerechnet ab dem created_at-Wert der Aufgabe, bevor Sie aufhören zu warten. Wenn Sie früher aufhören, könnten Sie eine Aufgabe verpassen, die später erfolgreich abgeschlossen wird. Dies kommt vor allem in Zeiten hoher Auslastung vor.
• Bewahren Sie die Task-ID auf. Sie können die Aufgabe jederzeit erneut abrufen. Wenn sie nach 60 Minuten immer noch nicht final ist, prüfen Sie sie später erneut. Bleibt dieser Zustand bestehen, 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:

Verwenden Sie bei vielen gleichzeitigen Aufgaben Webhooks anstelle von einzelnen Abfragen. Wenn das finale Ereignis einer Aufgabe nach etwa dem Doppelten ihrer typischen Zeit noch nicht eingetroffen ist, rufen Sie die Aufgabe über ihren GET-Endpunkt ab.