Reparera utskrivbarhet API

Krävs om du inte skickar model_url. ID:t för uppgiften vars modell du vill reparera, till exempel en Image to 3D-, Multi-Image to 3D-, Text to 3D-, Remesh-, Retexture- eller Analyze Printability-uppgift. Uppgiften måste vara en du skapat med API:et, med status SUCCEEDED och en GLB-modell.

En Analysera utskrivbarhet-uppgift som kontrollerade väggtjocklek skickar också vidare sin skrivare och storlek. Reparationen kontrollerar då väggtjocklek och förtjockar tunna väggar, även om du inte skickar någon av dem. En printer_type eller utskriftsstorlek du skickar ersätter den från analysen. En Analysera utskrivbarhet-uppgift av en .stl-, .fbx- eller .gltf-fil från model_url fungerar inte. Skicka den filen som model_url istället.

Krävs om du inte skickar input_task_id. Modellen som ska repareras, som en offentlig URL eller en data-URI. Om du skickar båda använder Meshy input_task_id.

Från en http- eller https-URL måste modellen vara en .glb-, .gltf-, .obj-, .fbx- eller .stl-fil på högst 400 MB. En data-URI kan bara innehålla en base64 GLB (data:model/gltf-binary;base64,...) eller glTF (data:model/gltf+json;base64,...) fil på högst 100 MB. Skicka en .obj-, .fbx- eller .stl-fil som en http- eller https-URL.

En fil över 100 MB måste också följa dessa regler:

• En GLB-, glTF-, FBX- eller OBJ-fil kan ha högst 10 000 000 ytor. Meshy räknar ytor som trianglar, så en fyrkant räknas som 2, och ett nät som ritas mer än en gång räknas en gång per kopia.
• En FBX-fil måste vara binär FBX 7.1 eller nyare.
• En GLB- eller glTF-fil får inte använda Draco-komprimering.

En Meshy-nedladdnings-URL (assets.meshy.ai/…?Expires=…&Signature=…) är signerad och slutar fungera vid sin uppgifts expires_at. Att läsa uppgiften igen förnyar den inte. För en modell du skapat med Meshy, skicka input_task_id istället, vilket fungerar så länge Meshy behåller källuppgiften (se Asset retention). För att använda modellen efter det, ladda ner den före expires_at och skicka din egen kopia.

Om en förhandsgranskning med transparent bakgrund (RGBA) också ska renderas, returnerad i alpha_thumbnail_url när du hämtar uppgiften. thumbnail_url ändras inte.

Skrivaren du planerar att använda. Den anger den minsta väggtjocklek reparationen siktar mot. Om du skickar en utskriftsstorlek utan printer_type, använder Meshy fdm, om inte en Analysera utskrivbarhet-uppgift i input_task_id tillhandahåller skrivaren.

Tillgängliga värden:

• fdm: filament, 1.0 mm minsta väggtjocklek
• sla: harts, 0.8 mm minsta väggtjocklek
• full_color: fullfärg, 2.0 mm minsta väggtjocklek

Alla andra värden returnerar 400.

Höjden på utskriften, i millimeter, från 1 till 1000. Ett värde utanför intervallet returnerar 400. Skicka den här eller intended_print_longest_side_mm, inte båda.

Den fungerar bara med GLB-indata. För en model_url som inte är en .glb-fil, skicka intended_print_longest_side_mm istället.

Längden på utskriftens längsta sida, i millimeter, från 1 till 1000. Ett värde utanför intervallet returnerar 400. Den fungerar med alla indataformat.

Begäran kan inte köras. Felmeddelandet anger vilket problem som hittades. Till exempel:

• Saknad parameter: Varken input_task_id eller model_url skickades.
• Ogiltig UUID: input_task_id är inte en giltig UUID.
• Ogiltig modell-URL: model_url är felformaterad, använder ett icke-stödt schema, eller har ett icke-stödt filtillägg.
• Modellfil för stor: Filen i model_url är över 400 MB från en http- eller https-URL, eller över 100 MB som en data-URI.
• För många ytor: Filen i model_url är en GLB-, glTF-, FBX- eller OBJ-fil över 100 MB med mer än 10 000 000 ytor. Minska antalet ytor och skicka sedan filen igen.
• ASCII-FBX över 100 MB: Filen i model_url är en ASCII-FBX över 100 MB. Skicka den som binär FBX eller GLB.
• Oläsbar modellfil: Filen i model_url är över 100 MB, och Meshy kan inte läsa dess header. Till exempel är det en Draco-komprimerad GLB eller glTF, eller en binär FBX äldre än 7.1.
• Modellhuvud för komplext: Filen i 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 och skicka den sedan igen.
• Modellfilen kan inte laddas ner: model_url returnerade ett fel, oftast för att en signerad Meshy-nedladdnings-URL löpt ut. Att läsa uppgiften igen returnerar samma URL med samma utgångsdatum. Skicka din egen kopia av filen, eller skicka input_task_id medan Meshy behåller källuppgiften.
• Uppgift inte lyckad: Uppgiften input_task_id väntar fortfarande, pågår, eller har misslyckats.
• Saknad GLB: Uppgiften input_task_id har ingen GLB-modell att reparera.
• Ogiltig utskriftsstorlek: intended_print_height_mm eller intended_print_longest_side_mm ligger utanför 1 till 1000, eller begäran har båda.
• Okänd skrivartyp: printer_type är inte fdm, sla eller full_color.
• Höjd på en icke-GLB-modell: Begäran har intended_print_height_mm och en model_url som inte är en .glb-fil. Skicka intended_print_longest_side_mm istället.
• Kan inte storleksätta den här modellen efter höjd: Vid den begärda höjden, eller standardvärdet 150 mm, skulle modellens längsta sida ligga utanför 1 till 1 000 mm. Detta inträffar också när modellen är platt, eller när Meshy inte kan avgöra dess storlek. Skicka intended_print_longest_side_mm istället. För en .glb model_url och vissa input_task_id-uppgifter upptäcker Meshy detta först efter att uppgiften startat, och uppgiften slutar istället som FAILED.
• STL-storlek oanvändbar: Begäran har printer_type utan en storlek, och Meshy kan inte läsa .stl-filens egen längsta sida, eller den ligger utanför 1 till 1 000 mm. Skicka intended_print_longest_side_mm.

Åtgärda begäran och skicka den sedan igen. Se Fel.

API-nyckeln saknas eller är ogiltig. Kontrollera Authorization-headern.

Till exempel:

• Otillräckliga credits: Kontot har inte tillräckligt med credits för denna uppgift, eller kontot har nått en creditgräns. Kontrollera ditt saldo av credits och försök sedan igen.
• Gratisplan: Att skapa en uppgift kräver en betald plan. Uppgradera din plan i dina prenumerationsinställningar och försök sedan igen.

input_task_id är en basreliefmodell, vilket denna endpoint inte kan reparera. Meddelandet är This model type does not support this operation. Skicka en annan modell.

Uppgiften input_task_id finns inte eller tillhör en annan användare. Kontrollera ID:t, och använd en API-nyckel från kontot som skapade uppgiften.

Du överskred din hastighetsgräns, eller du har för många väntande uppgifter. Vänta och försök sedan igen. Se Rate limits.

Uppgifts-ID från skapandesvaret.

ID:t för uppgiften som ska tas bort.

Sidnumret som ska returneras, med start på 1.

Antalet uppgifter per sida, upp till 100.

Sorteringsordningen.

Tillgängliga värden:

• +created_at: äldsta först
• -created_at: nyaste först

Uppgifts-ID:t från create-svaret.

Uppgifts-ID. Behandla det som en opak sträng och förlita dig inte på dess format.

Uppgiftstypen, alltid print-repair.

Uppgiftens status, en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED eller CANCELED.

Hur stor del av uppgiften som är klar, i procent. Den är 0 tills uppgiften startar och 100 när den lyckas.

Antalet uppgifter före denna i kön. Värdet är meningsfullt endast medan uppgiften är PENDING.

Tidpunkten då uppgiften skapades, i Unix-millisekunder.

Tidpunkten då uppgiften startade, i Unix-millisekunder. Den är 0 tills uppgiften startar.

Tidpunkten då uppgiften slutfördes, i Unix-millisekunder. Den är 0 tills uppgiften slutförs.

Tidpunkten då uppgiftens resultat upphör att gälla, i Unix-millisekunder. Den är 0 tills uppgiften slutförs.

Felinformationen när uppgiften misslyckas. Den är null om uppgiften inte har misslyckats. Se Fel.

Nedladdnings-URL:er för den reparerade modellen. Den har endast nyckeln som matchar indataformatet. Ett format som uppgiften inte genererade saknar nyckel, istället för en tom sträng.

Nedladdnings-URL för en förhandsgranskningsbild av den reparerade modellen.

Nedladdnings-URL för en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast när du skapade uppgiften med alpha_thumbnail: true och Meshy renderade den transparenta förhandsgranskningen.

Alltid en tom array. Repair behåller endast indatageometrin och bakar inte om texturer.

Antalet credits som uppgiften använde. Det är 10 när uppgiften är SUCCEEDED, och 0 för en FAILED-uppgift, eftersom Meshy återbetalar credits när en uppgift misslyckas.

Skrivaren och storleken som reparationen använde, oavsett om du skickade dem eller Meshy återanvände dem från en Analyze Printability-uppgift. Finns med på en väggtjockleksreparation från start, även medan uppgiften är PENDING. Ett värde som Meshy ännu inte känner till är null.

Vad väggtjockleksreparationen gjorde. Finns efter att en väggtjockleksreparation lyckas.