Reparera utskrivbarhet API

ID:t för en lyckad uppgift som du äger. Uppgiftstyper som stöds: Bild till 3D, Flera bilder till 3D, Text till 3D, Remesh, Omtexturering, och Analysera utskrivbarhet. Uppgiften måste ha statusen SUCCEEDED och måste ha genererat en GLB-tillgång.

En analysuppgift som kontrollerade väggtjocklek skickar också vidare sin skrivare och storlek, så reparationen kontrollerar väggtjocklek, och förtjockar tunna väggar, även om du inte skickar något av dem; en printer_type eller utskriftsstorlek du skickar åsidosätter det värdet. Analysuppgifter som skapats från en .stl-, .fbx- eller .gltf-model_url accepteras inte: skicka filen som model_url istället.

URL till en 3D-modell att reparera. Format som stöds: .glb, .gltf, .obj, .fbx, .stl. Använd en http- eller https-URL, eller en base64 data:-URL för en GLB (data:model/gltf-binary;base64,...) eller glTF (data:model/gltf+json;base64,...). .obj-, .fbx- och .stl-filer måste skickas som en http- eller https-URL.

Maximal filstorlek: 400 MB för en http- eller https-URL, 100 MB för en data:-URI.

En GLB-, glTF-, FBX- eller OBJ-fil över 100 MB kan ha som mest 10 000 000 ytor. Ytor räknas som trianglar: en fyrkant räknas som 2, och ett nät som ritas mer än en gång räknas en gång per kopia. Över 100 MB måste en FBX-fil vara binär FBX 7.1 eller nyare, och en GLB- eller glTF-fil får inte använda Draco-komprimering.

Meshys nedladdnings-URL:er (assets.meshy.ai/…?Expires=…&Signature=…) är signerade och slutar fungera vid uppgiftens expires_at; att hämta uppgiften igen förnyar dem inte. För en modell genererad med Meshy, skicka input_task_id istället. Det fungerar så länge källuppgiften bevaras (se Asset Retention). För att återanvända en modell efter det, ladda ner den innan expires_at och skicka din egen kopia.

När satt till true renderar uppgiften dessutom en version med transparent bakgrund (RGBA) av förhandsgranskningen och returnerar den som alpha_thumbnail_url i GET-svaret. Det befintliga fältet thumbnail_url förblir oförändrat.

Skrivaren du planerar att använda. Den sätter den minsta väggtjocklek som reparationen siktar mot. Standard är fdm när du skickar en utskriftsstorlek utan den, såvida inte en analysuppgift som skickats som input_task_id tillhandahåller skrivaren.

Tillgängliga värden:

• fdm: filament, 1.0 mm minsta vägg.
• sla: resin, 0.8 mm minsta vägg.
• full_color: full färg, 2.0 mm minsta vägg.

Höjden på utskriften, i millimeter. Intervall: [1, 1000]. Avrundas till närmaste millimeter. Endast GLB-indata.

Längden på utskriftens längsta sida, i millimeter. Intervall: [1, 1000]. Avrundas till närmaste millimeter. Fungerar med alla indataformat.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: varken input_task_id eller model_url angavs.
• Ogiltig UUID: input_task_id är inte ett giltigt UUID.
• Ogiltig modell-URL: model_url är felformaterad, använder ett schema som inte stöds, eller har ett filtillägg som inte stöds.
• Modellfil för stor: model_url-innehållet överskred 400 MB (http- eller https-URL) eller 100 MB (data:-URI).
• För många ytor: model_url är en GLB-, glTF-, FBX- eller OBJ-fil över 100 MB med fler än 10 000 000 ytor. Minska antalet ytor, skicka sedan filen igen.
• ASCII FBX över 100 MB: model_url är en ASCII FBX över 100 MB. Skicka den som binär FBX eller GLB.
• Oläsbar modellfil: model_url är över 100 MB och dess header kan inte läsas, till exempel en Draco-komprimerad GLB eller glTF, eller en binär FBX äldre än 7.1.
• Modellheader för komplex: model_url är över 100 MB och dess header har för många nät, noder eller poster att kontrollera. Minska antalet objekt i filen, skicka den sedan igen.
• Modellfilen kunde inte laddas ner: model_url returnerade ett fel, oftast eftersom en signerad Meshy-nedladdnings-URL har upphört. Att hämta uppgiften igen returnerar samma URL med samma utgångstid, så skicka din egen kopia av filen, eller använd input_task_id medan källuppgiften fortfarande bevaras.
• Uppgift inte lyckad: den refererade uppgiften är fortfarande väntande, pågående, eller misslyckad.
• Saknad GLB: den refererade uppgiften har ingen GLB-tillgång att reparera.
• Ogiltig utskriftsstorlek: intended_print_height_mm eller intended_print_longest_side_mm är utanför [1, 1000], eller båda skickades.
• Okänd skrivartyp: printer_type är inte fdm, sla, eller full_color.
• Höjd på en icke-GLB-modell: intended_print_height_mm skickades med en model_url som inte är .glb. Använd intended_print_longest_side_mm istället.
• Kan inte storleksanpassa denna modell efter höjd: vid den begärda höjden (eller standardvärdet 150 mm) skulle modellens längsta sida vara utanför [1, 1000] mm, modellen är platt, eller dess storlek kan inte bestämmas. Använd intended_print_longest_side_mm istället. För en .glb model_url och vissa input_task_id-uppgifter upptäcks detta först efter att uppgiften startat, och uppgiften slutar då med FAILED istället.
• STL-storlek oanvändbar: printer_type skickades utan en storlek, och STL-filens egen längsta sida kan inte läsas eller är utanför [1, 1000] mm. Skicka intended_print_longest_side_mm.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Vanliga orsaker:

• Gratisplan: att skapa uppgifter kräver en betald plan. Uppgradera på prenumerationssidan.
• Otillräckliga credits: gränsen för arbetsytans credits har nåtts.

Den refererade uppgiften finns inte eller ägs av en annan användare.

Du har överskridit din kvot för väntande uppgifter eller din hastighetsgräns.

ID:t för den reparera-utskrivbarhet-uppgift som ska hämtas.

ID:t för den uppgift för reparera utskrivbarhet som ska tas bort.

Sidnummer för paginering. Börjar och har standardvärdet 1.

Gräns för sidstorlek. Standardvärdet är 10 objekt. Maximalt tillåtet är 100 objekt.

Fält att sortera efter. Tillgängliga värden:

• +created_at: Sortera efter skapandetid i stigande ordning.
• -created_at: Sortera efter skapandetid i fallande ordning.

Unik identifierare för reparera-utskrivbarhet-uppgiften som ska strömmas.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id som implementationsdetalj bör du inte göra några antaganden om id:ts format.

Typ av reparera utskrivbarhet-uppgiften. Värdet är print-repair.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Uppgiftens progress. Om uppgiften inte har påbörjats ännu kommer denna egenskap att vara 0. När uppgiften har lyckats blir detta 100.

Antalet föregående uppgifter.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startats ännu kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften inte har avslutats ännu kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiftens resultat upphör att gälla i systemet, i millisekunder. 0 om uppgiften ännu inte har avslutats.

Felinformation om uppgiften har misslyckats. Denna egenskap är null om uppgiften inte har misslyckats. Se Fel för mer information.

Nedladdningsbara URL:er till den reparerade 3D-modellen. Endast fältet som matchar indataformatet fylls i; de övriga formatfälten är tomma strängar.

URL till en förhandsgranskningsbild renderad från den reparerade modellen.

Nedladdningsbar URL till en version med transparent bakgrund (RGBA) av thumbnail_url. Finns endast med när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsgranskningen renderades korrekt; annars utelämnas detta fält.

Alltid en tom array. Reparation bevarar endast indatans geometri och bakar inte om texturer.

Antalet credits som förbrukats av denna uppgift. 10 när uppgiften har nått SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).

Skrivaren och storleken som reparationen använde, oavsett om den skickades eller återanvändes från en analysera-uppgift. Finns med i en väggtjocklek-reparation från start (PENDING); värden som ännu inte är kända är null.

Vad väggtjockleksreparationen gjorde. Finns med så snart en väggtjockleksreparation har lyckats.