Levenscyclus van een taak
Leer hoe een taak van aanvraag naar resultaat verloopt, hoe lang dit meestal duurt, en hoe lang je code erop moet wachten.
Hoe een taak verloopt
Een create-aanvraag retourneert een taak-ID zonder te wachten tot de taak is uitgevoerd. De taak draait vervolgens op de achtergrond, en je volgt deze op een van drie manieren: de GET-endpoint pollen, de stream-endpoint openen, of een webhook ontvangen.
PENDING. Een worker pakt deze op en de status wordt IN_PROGRESS, waar de taak het grootste deel van de tijd in doorbrengt. De taak eindigt met SUCCEEDED of FAILED, en een eindstatus verandert nooit meer.PENDINGIN_PROGRESSSUCCEEDEDFAILEDDe taak legt elke stap vast in de velden created_at, started_at en finished_at.
De volgende tabel laat zien wat je code bij elke status moet doen.
| Status | Wat je code moet doen |
|---|---|
PENDING | Blijf wachten. |
IN_PROGRESS | Houd progress bij: het percentage van het werk dat is voltooid, van 0 tot 100. |
SUCCEEDED | Download het resultaat. Meshy bewaart de bestanden gedurende een beperkte tijd. Zie Asset-retentie. |
FAILED | Lees task_error en herstel de invoer of maak een nieuwe taak aan. Zie Fouten. |
CANCELED | Stop met wachten. De taak zal geen resultaat opleveren. Alleen Creative Lab-taken gebruiken deze 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 als volgt uit:
Aanvraag: POST/image-to-3d
Antwoord: 202{ "result": "<task_id>" }taak aangemaakt
- Herhaal elke paar seconden
Aanvraag: GET/image-to-3d/<task_id>
Antwoord: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
Aanvraag: GET/image-to-3d/<task_id>
Antwoord: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
GET en dezelfde taak-ID.Verwerkingstijden
De volgende tabellen tonen mediane tijden op basis van productie-API-verkeer in september 2026.
Een tijd loopt van het aanmaken van de taak tot de eindstatus. Bijna de volledige tijd is verwerking, omdat een taak meestal maar enkele seconden in PENDING blijft. Wanneer de wachtrij druk bezet is, kunnen taken langer wachten voordat ze starten, en taken op abonnementen met een hogere prioriteit starten meestal sneller.
Tijden onder de 2 minuten staan in seconden (s), en langere tijden in minuten (min). Niet ondersteund betekent dat de API die optie niet biedt bij dat model.
Dit zijn typische tijden, geen gegarandeerde doorlooptijden. Tijdens drukke periodes duren sommige taken langer en slagen ze alsnog. Om de status van Meshy te controleren, zie de statuspagina. Gebruik deze tijden niet als timeouts in je code. Voor timeout-waarden, zie Hoe lang wachten.
3D-generatie
| API | Configuratie | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Tekst naar 3D (Preview) | Alleen mesh | 75 s | 90 s | 45 s | 10 s |
| Afbeelding naar 3D | Alleen mesh | 75 s | 90 s | 40 s | 4 s |
| Mesh met 2K-texturen | 2 min | 3 min | 75 s | 60 s | |
| Mesh met 4K-texturen | 2,5 min | 3,5 min | Niet ondersteund | 80 s | |
| Mesh met 8K-texturen | 3,5 min | 4 min | Niet ondersteund | 2,5 min | |
| Multi-afbeelding naar 3D | Alleen mesh | 65 s | 2 min | 30 s | Niet ondersteund |
| Mesh met 2K-texturen | 2,5 min | 3,5 min | 85 s | Niet ondersteund | |
| Mesh met 4K-texturen | 3 min | 4 min | Niet ondersteund | Niet ondersteund | |
| Mesh met 8K-texturen | 3,5 min | 4,5 min | Niet ondersteund | Niet ondersteund |
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
| API | Textuurresolutie | Typische tijd |
|---|---|---|
| Tekst naar 3D (Refine) | 2K of 4K | 80 s |
| 8K | 3,5 min | |
| Hertextureren | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2,5 min |
Afbeeldingsgeneratie
| API | nano-banana | nano-banana-2 | nano-banana-pro | GPT Image-modellen |
|---|---|---|---|---|
| Tekst naar afbeelding | 20 s | 15 s | 25 s | 20 tot 35 s |
| Afbeelding naar afbeelding | 40 s | 20 s | 30 s | 20 tot 40 s |
Rigging en Animatie
| API | Configuratie | Typische tijd |
|---|---|---|
| Auto-Rigging | Automatische rigging | 40 s |
| Animatie | Per aanvraag | 15 s |
| Tekst naar beweging | prime-mode | 15 s |
swift-mode | 10 s |
Nabewerking
| API | Typische tijd |
|---|---|
| Remesh | 2 min |
| UV-unwrap | 35 s |
| Converteren | 7 s |
| Formaat wijzigen | 15 s |
3D-printen
| API | Configuratie | Typische tijd |
|---|---|---|
| Printbaarheid analyseren | Alleen mesh-controles | 1 s |
| Mesh- en dunwand-controles | 10 s | |
| Multi-Color | Per aanvraag | 30 s |
| Printbaarheid repareren | Alleen mesh-reparatie | 10 s |
| Dunwand-controle, wanden behouden | 20 s | |
| Dunwand-controle, wanden verdikt | 100 s | |
| Auto Split | Effen gekleurde onderdelen | 70 s |
Onderdelen met textuur (keep_texture: true) | 170 s |
Op v2 voeren Printbaarheid repareren en Printbaarheid analyseren altijd de dunwand-controle uit. Op v1 voeren ze deze uit wanneer je een printertype of printformaat meestuurt.
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 ten minste 60 minuten, gerekend vanaf
created_atvan de taak, voordat je stopt met wachten. Als je eerder stopt, kun je een taak missen die later alsnog slaagt. Dit gebeurt vooral tijdens drukke periodes. - Bewaar de taak-ID. Je kunt de taak op elk moment opnieuw ophalen. Als deze na 60 minuten nog steeds geen eindstatus heeft, controleer dan later opnieuw. Als dit zo blijft, neem contact op met support.
- Alleen
FAILEDbetekent dat de taak is mislukt. Meshy betaalt mislukte taken automatisch terug.
Gebruik deze waarden in je code:
| Instelling | Aanbevolen waarde |
|---|---|
Timeout voor create-aanvraag (POST) | 60 seconden |
Timeout voor create-aanvraag (POST) met een model_url-bestand groter dan 100 MB | 120 seconden. Meshy downloadt het bestand voordat het antwoord geeft. |
Timeout voor statusaanvraag (GET) | 30 seconden |
| Poll-interval | De Retry-After-header, of 5 seconden als deze ontbreekt. Polls tellen mee voor je rate limit. |
Mislukte statusaanvraag (timeout, 429 of 5xx) | Probeer het opnieuw bij de volgende poll. Dit betekent niet dat de taak is mislukt. |
| Totale wachttijd per taak | Ten minste 60 minuten vanaf created_at. Start deze telling niet opnieuw wanneer je een stream opnieuw verbindt. |
| Stream | Een stream kan sluiten voordat de taak is voltooid. Sluit deze zonder eindstatus, verbind dan opnieuw of schakel over op polling. |
Gebruik voor veel taken tegelijk webhooks in plaats van elke taak afzonderlijk te pollen. Als het eindevent van een taak na ongeveer twee keer de typische tijd nog niet is binnengekomen, haal de taak dan op via de GET-endpoint.