Levenscyclus van een taak

Leer hoe een taak van aanvraag naar resultaat gaat, hoe lang dit meestal duurt, en hoe lang je code erop moet wachten.

Hoe een taak verloopt

Een create-aanvraag geeft een taak-ID terug zonder te wachten tot de taak is uitgevoerd. De taak draait vervolgens op de achtergrond, en je kunt deze op drie manieren volgen: de GET-endpoint pollen, de stream-endpoint openen, of een webhook ontvangen.

De taak registreert elke stap in de velden created_at, started_at en finished_at.

De volgende tabel laat zien wat je code moet doen bij elke status.

SUCCEEDED, FAILED en CANCELED zijn definitief. Zodra een taak een van deze statussen bereikt, verandert de status nooit meer.

Vanuit je code ziet dit er zo uit:

Verwerkingstijden

De volgende tabellen tonen mediaantijden op basis van productie-API-verkeer in september 2026.

Een tijd loopt van het aanmaken van de taak tot de eindstatus. Bijna de hele tijd is verwerkingstijd, omdat een taak meestal maar een paar seconden in PENDING blijft. Wanneer de wachtrij druk is, kunnen taken langer wachten voordat ze starten, en taken op abonnementen met een hogere prioriteit starten meestal eerder.

Tijden onder de 2 minuten staan in seconden (s), en langere tijden in minuten (min). "Niet ondersteund" betekent dat de API die optie niet aanbiedt bij dat model.

3D-generatie

Voor Afbeelding naar 3D en Multi-afbeelding naar 3D betekent "Alleen mesh" should_texture: false. Deze opties en invoer veranderen de tijd:

• PBR-maps (enable_pbr) voegen 30 tot 60 seconden toe.
• Ultra-geometrie (geometry_resolution: "2k" of "4k") voegt tot 1 minuut toe.
• Bij dezelfde instellingen duren complexere invoerafbeeldingen langer.

Textureren

Afbeeldingsgeneratie

Rigging en animatie

Nabewerking

3D-printen

Bij v2 voeren Printbaarheid repareren en Printbaarheid analyseren altijd de dunnewand-controle uit. Bij v1 voeren ze deze uit wanneer je een printertype of een printformaat meegeeft.

Hoe lang wachten

De taak blijft draaien, zelfs als je code stopt met wachten. Als je aanvraag een timeout krijgt, je verbinding wegvalt, of je stream sluit, mislukt de taak niet en wordt deze niet geannuleerd.

• Wacht minstens 60 minuten, gerekend vanaf de created_at van de taak, voordat je stopt met wachten. Als je eerder stopt, mis je mogelijk een taak die later alsnog slaagt. Dit gebeurt vooral tijdens drukke periodes.
• Bewaar de taak-ID. Je kunt de taak op elk moment opnieuw opvragen. Is deze na 60 minuten nog steeds niet definitief, controleer dan later opnieuw. Blijft dit zo, neem dan contact op met support.
• Alleen FAILED betekent dat de taak is mislukt. Meshy betaalt mislukte taken automatisch terug.

Gebruik deze waarden in je code:

Gebruik voor veel taken tegelijk webhooks in plaats van elke taak afzonderlijk te pollen. Als het eindevent van een taak niet is binnengekomen na ongeveer twee keer de typische tijd, haal de taak dan op via de GET-endpoint.