lowpoly avvecklas den 30 okt. 2026. meshy-7 som 3D-genereringsmodell avvecklas den 31 dec. 2026; som texturmodell finns den kvar. Byt modell före dessa datum för att undvika fel i förfrågningar. Se alla utfasningar

Uppgiftens livscykel

Lär dig hur en uppgift går från förfrågan till resultat, hur lång tid det vanligtvis tar och hur länge din kod bör vänta på den.


Hur en uppgift körs

En skapandeförfrågan returnerar ett uppgifts-ID utan att vänta på att uppgiften ska köras. Uppgiften körs sedan i bakgrunden, och du följer den på ett av tre sätt: poll:a dess GET-endpoint, öppna dess ström-endpoint, eller ta emot en webhook.

En skapandeförfrågan startar en uppgift i PENDING. En arbetare plockar upp den och den övergår till IN_PROGRESS, där den tillbringar det mesta av sin tid. Den avslutas i SUCCEEDED eller FAILED, och en slutstatus ändras aldrig.
Skapandeförfrågan
PENDING
Väntar i kön
IN_PROGRESS
Genererar resultatet
SUCCEEDED
Ladda ner resultatet
FAILED
Credits återbetalade

Uppgiften registrerar varje steg i sina fält created_at, started_at och finished_at.

Följande tabell visar vad din kod bör göra vid varje status.

StatusVad din kod bör göra
PENDINGFortsätt vänta.
IN_PROGRESSSpåra progress: procentandelen av arbetet som är klart, från 0 till 100.
SUCCEEDEDLadda ner resultatet. Meshy sparar filerna under en begränsad tid. Se Tillgångslagring.
FAILEDLäs task_error, och åtgärda sedan indatan eller skapa en ny uppgift. Se Fel.
CANCELEDSluta vänta. Uppgiften kommer inte att producera något resultat. Endast Creative Lab-uppgifter använder denna status.

SUCCEEDED, FAILED och CANCELED är slutgiltiga. När en uppgift når en av dessa ändras dess status aldrig igen.

Från din kod ser det ut så här:

Skapa en uppgift och poll:a den sedan tills den är klar.
  1. Förfrågan: POST/image-to-3d

  2. Svar: 202{ "result": "<task_id>" }uppgift skapad

  3. Upprepa var några sekunder
    1. Förfrågan: GET/image-to-3d/<task_id>

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

  4. Förfrågan: GET/image-to-3d/<task_id>

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

Om din app slutar vänta fortsätter uppgiften att köras. Hämta den senare med GET med samma uppgifts-ID.

Bearbetningstider

Följande tabeller visar mediantider för produktions-API-trafik i september 2026.

En tid löper från att uppgiften skapas till slutstatus. Nästan hela tiden utgörs av bearbetning, eftersom en uppgift vanligtvis bara stannar i PENDING i några sekunder. När kön är upptagen kan uppgifter vänta längre innan de startar, och uppgifter på planer med högre prioritet startar vanligtvis snabbare.

Tider under 2 minuter anges i sekunder (s), och längre tider i minuter (min). Stöds inte betyder att API:et inte erbjuder det alternativet med den modellen.

3D-generering

APIKonfigurationmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Text till 3D (Preview)Endast nät75 s90 s45 s10 s
Bild till 3DEndast nät75 s90 s40 s4 s
Nät med 2K-texturer2 min3 min75 s60 s
Nät med 4K-texturer2,5 min3,5 minStöds inte80 s
Nät med 8K-texturer3,5 min4 minStöds inte2,5 min
Flera bilder till 3DEndast nät65 s2 min30 sStöds inte
Nät med 2K-texturer2,5 min3,5 min85 sStöds inte
Nät med 4K-texturer3 min4 minStöds inteStöds inte
Nät med 8K-texturer3,5 min4,5 minStöds inteStöds inte

För Bild till 3D och Flera bilder till 3D betyder "Endast nät" should_texture: false. Dessa alternativ och indata ändrar tiden:

  • PBR-mappar (enable_pbr) lägger till 30 till 60 sekunder.
  • Ultra-geometri (geometry_resolution: "2k" eller "4k") lägger till upp till 1 minut.
  • Med samma inställningar tar mer komplexa indatabilder längre tid.

Texturering

APITexturupplösningTypisk tid
Text till 3D (Refine)2K eller 4K80 s
8K3,5 min
Omtexturering2K55 s
4K90 s
8K2,5 min

Bildgenerering

APInano-banananano-banana-2nano-banana-proGPT Image-modeller
Text till bild20 s15 s25 s20 till 35 s
Bild till bild40 s20 s30 s20 till 40 s

Rigging och Animation

APIKonfigurationTypisk tid
Auto-RiggingAutomatisk rigging40 s
AnimationPer förfrågan15 s
Text to Motionprime-mode15 s
swift-mode10 s

Efterbearbetning

3D-utskrift

APIKonfigurationTypisk tid
Analysera utskrivbarhetEndast nätkontroller1 s
Nät- och tunnväggskontroller10 s
Multi-ColorPer förfrågan30 s
Reparera utskrivbarhetEndast nätreparation10 s
Tunnväggskontroll, väggar bibehålls20 s
Tunnväggskontroll, väggar förtjockas100 s
Auto SplitDelar med enfärgad yta70 s
Texturerade delar (keep_texture: true)170 s

I v2 kör Reparera utskrivbarhet och Analysera utskrivbarhet alltid tunnväggskontrollen. I v1 körs den när du skickar en skrivartyp eller en utskriftsstorlek.


Hur länge man ska vänta

Uppgiften fortsätter att köras även om din kod slutar vänta. Om din förfrågan får timeout, din anslutning bryts eller din ström stängs, misslyckas uppgiften inte och avbryts inte.

  • Vänta minst 60 minuter, räknat från uppgiftens created_at, innan du slutar vänta. Om du slutar tidigare kan du missa en uppgift som lyckas senare. Detta händer främst under hektiska perioder.
  • Behåll uppgifts-ID:t. Du kan hämta uppgiften igen när som helst. Om den fortfarande inte är slutgiltig efter 60 minuter, kontrollera den igen senare. Om den förblir så, kontakta supporten.
  • Endast FAILED betyder att uppgiften misslyckades. Meshy återbetalar misslyckade uppgifter automatiskt.

Använd dessa värden i din kod:

InställningRekommenderat värde
Timeout för skapandeförfrågan (POST)60 sekunder
Timeout för skapandeförfrågan (POST) med en model_url-fil över 100 MB120 sekunder. Meshy laddar ner filen innan det svarar.
Timeout för statusförfrågan (GET)30 sekunder
Poll-intervallRetry-After-huvudet, eller 5 sekunder om det saknas. Poll-anrop räknas mot din hastighetsgräns.
Misslyckad statusförfrågan (timeout, 429 eller 5xx)Försök igen vid nästa poll-anrop. Det betyder inte att uppgiften misslyckades.
Total väntetid per uppgiftMinst 60 minuter från created_at. Börja inte om denna räkning när du återansluter en ström.
StrömEn ström kan stängas innan uppgiften är klar. Om den stängs utan en slutstatus, återanslut eller växla till poll:ning.

För många uppgifter samtidigt, använd webhooks istället för att poll:a var och en. Om en uppgifts slutliga händelse inte har kommit efter ungefär dubbla dess typiska tid, hämta uppgiften från dess GET-endpoint.