Rigging API

Krävs om du inte skickar model_url. ID:t för uppgiften vars modell du vill rigga. Meshy stöder texturerade humanoida modeller.

Modellen kan ha högst 380 000 trianglar (en quad räknas som 2), och en modell med fler returnerar 400. För att hålla dig under gränsen kan du först köra Remesh API på den med ett target_polycount på 300000 eller lägre, eller 150000 eller lägre med topology: quad.

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

Modellen måste vara en GLB-fil (.glb) på högst 400 MB från en http- eller https-URL, eller 100 MB som en data-URI. Rigging stöder texturerade humanoida modeller.

Modellen kan ha högst 380 000 trianglar (en quad räknas som 2), och en modell med fler returnerar 400. För att hålla dig under gränsen kan du först köra Remesh API på den med ett target_polycount på 300000 eller lägre, eller 150000 eller lägre med topology: quad.

Karaktärens ansikte måste peka mot +Z-axeln, standardriktningen framåt i glTF. Positionuppskattning (pose estimation) misslyckas för en modell som är vänd mot en annan axel.

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

• Den kan ha högst 10 000 000 ytor (faces). En fil med fler returnerar 400. Meshy räknar ytor som trianglar, och ett nät som ritas mer än en gång räknas en gång per kopia.
• Den får inte använda Draco-komprimering.

Karaktärens ungefärliga längd, i meter. Meshy använder det för att skala och rigga modellen mer exakt. Ett negativt värde returnerar 400.

Utelämna det när modellen har egna texturer. Utan det använder Meshy texturerna inbäddade i model_url-filen, eller indatauppgiftens texturer. Om du skickar det blir denna bild den riggade modellens enda textur, och modellen förlorar sina PBR-mappar.

Modellens UV-upprullade (UV-unwrapped) baskulörstextur, antingen som en offentlig URL eller en data-URI. Bilden måste vara en PNG-fil på högst 20 MB. Ett annat bildformat returnerar 400.

Förfrågan kan inte köras. Felmeddelandet anger vilket problem det hittade. Till exempel:

• Saknad parameter: Varken model_url eller input_task_id skickades.
• Ogiltigt modellformat: model_url-filen har ett filtillägg som inte stöds. Endast .glb stöds.
• Oåtkomlig URL: Meshy kan inte ladda ner model_url-filen.
• Modellfilen för stor: model_url-filen är över 400 MB från en http- eller https-URL, eller över 100 MB som en data-URI.
• För många ytor: model_url-filen är över 100 MB och har fler än 10 000 000 ytor. Minska antalet ytor och skicka filen igen.
• Oläsbar modellfil: model_url-filen är över 100 MB, och Meshy kan inte läsa dess header. Till exempel är den en Draco-komprimerad GLB.
• Modellheader för komplex: model_url-filen ä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 igen.
• Bilden för stor: texture_image_url-bilden är över 20 MB.
• Ogiltigt texturformat: texture_image_url-bilden är inte en PNG-fil.
• Ogiltig höjd: height_meters är negativ.
• Ogiltig indatauppgift: input_task_id hänvisar inte till en giltig API-uppgift.
• Indatauppgift inte redo: Uppgiften input_task_id har inte nått SUCCEEDED. Vänta tills den lyckas och försök sedan igen.
• Ytantal överskridet: Indatamodellen har fler än 380 000 trianglar (en quad räknas som 2). Kör Remesh API på den med ett target_polycount på 300000 eller lägre, eller 150000 eller lägre med topology: quad, innan du riggar modellen.

Åtgärda förfrågan 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 creditsaldo och försök sedan igen.
• Gratisplan: Att skapa en uppgift kräver en betalplan. Uppgradera din plan i dina prenumerationsinställningar och försök sedan igen.

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

Meshy kan inte hitta filerna för uppgiften input_task_id. Någon av dessa gäller:

• Meshy raderade uppgiftens filer efter dess expires_at. Skapa uppgiften igen och skicka sedan den uppgiftens ID.
• Uppgiften saknar någon av de filer som rigging behöver, till exempel en förhandsgranskningsbild, exempelvis en Konvertera-uppgift. Rigga uppgiften den kom ifrån, eller skicka modellen som model_url.

Positionuppskattningen (pose estimation) misslyckades. Modellen kanske inte är en giltig humanoid karaktär. Skicka en modell av en humanoid karaktär. För model_url, kontrollera även att karaktären är vänd mot +Z-axeln.

Du överskred din hastighetsgräns. Vänta och försök sedan igen. Se Hastighetsgränser.

Uppgifts-ID:t från skapandesvaret.

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

Uppgifts-ID:t från skapandesvaret.

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

Aktivitetstypen, alltid rig.

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

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

Tidpunkten då aktiviteten skapades, i Unix-millisekunder.

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

Tidpunkten då aktiviteten avslutades, i Unix-millisekunder. Den är 0 tills aktiviteten avslutas.

Tidpunkten då aktivitetens resultatfiler upphör att gälla, i Unix-millisekunder. Efter denna tidpunkt kan Meshy radera filerna.

Feldetaljerna när aktiviteten misslyckas. Den är null om inte statusen är FAILED. Se Fel.

Antalet credits som aktiviteten använde. Finns med när statusen är PENDING, IN_PROGRESS eller SUCCEEDED. Den är 0 för en FAILED-aktivitet, eftersom Meshy återbetalar credits när en aktivitet misslyckas.

URL:erna till utdatafilerna. Tills aktiviteten lyckas är varje URL en tom sträng, och basic_animations är null.

Antalet aktiviteter som ligger före denna i kön. Värdet är endast meningsfullt medan aktiviteten är PENDING. Fältet utelämnas när värdet är 0.