Retexture API

ID:t för den slutförda Bild till 3D- eller Text till 3D-uppgiften du vill omtexturera. Denna uppgift måste vara en av följande: Text till 3D Preview, Text till 3D Refine, Bild till 3D eller Remesh. Dessutom måste den ha statusen SUCCEEDED.

Ange en 3D-modell för Meshy att texturera. Format som stöds: .glb, .gltf, .obj, .fbx, .stl.

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 polygoner. Polygoner räknas som trianglar: en fyrsidig polygon 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.

Det finns två sätt att ange modellen:

• Publikt tillgänglig URL: En URL som är tillgänglig från det publika internet.
• Data URI: En base64-kodad data-URI för modellen. Använd MIME type application/octet-stream. Exempel: data:application/octet-stream;base64,<din base64-kodade modelldata>.

Beskriv önskad texturstil för objektet med text. Maximalt 800 tecken.

Ange en 2D-bild som vägledning för textureringsprocessen. Vi stöder för närvarande formaten .jpg, .jpeg, .png och .webp.

Maximal filstorlek: 20 MB.

Det finns två sätt att ange bilden:

• Publikt tillgänglig URL: En URL som är tillgänglig från det publika internet
• Data URI: En base64-kodad data-URI för bilden. Exempel på en data-URI: data:image/jpeg;base64,<din base64-kodade bilddata>

Ange 1 till 4 bilder som visar samma objekt från olika vyer för att vägleda textureringen. Den första bilden är primärvyn (framifrån); ordningen på de återstående vyerna (vänster, bak, höger) spelar ingen roll.

Varje element godtar samma format som image_style_url (en publikt tillgänglig URL eller en base64 data-URI, .jpg/.jpeg/.png/.webp).

Maximal filstorlek: 20 MB per bild.

ID för den AI-modell som ska användas för omtexturering. Tillgängliga värden: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Behåll modellens befintliga UV-layout istället för att generera en ny.

• Om du omtexturerar en modell som Meshy har genererat (via input_task_id, eller en model_url som pekar på en Meshy-utdata), sätt detta till true för att återanvända dess optimerade UV-layout.
• Om du omtexturerar en tredjepartsmodell du har laddat upp, sätt true när den redan har bra UV:er som du vill behålla, eller lämna det som false för att låta Meshy packa upp nya UV:er (bäst för modeller som saknar korrekt UV-mappning).

Generera PBR-mappar (metallic, roughness, normal) utöver basfärgen. En emissionsmapp inkluderas också när ai_model är meshy-6, förutom vid texture_resolution: 8k. meshy-6-lite, meshy-7 och latest producerar ingen emissionsmapp.

Upplösning för basfärgstextur. En av 2k (2048×2048), 4k (4096×4096), eller 8k (8192×8192). Högre upplösningar fångar mer ytdetalj.

Använd texture_resolution istället — motsvarar texture_resolution: "4k". Om båda anges har texture_resolution företräde.

Tar bort highlights och skuggor från basfärgstexturen, vilket ger ett renare resultat som fungerar bättre med anpassade ljussättningar.

Anger vilka 3D-filformat som ska inkluderas i utdata. Endast de begärda formaten genereras och returneras, vilket kan minska uppgiftens slutförandetid. Om parametern utelämnas inkluderas alla format som stöds.

Tillgängliga värden: glb, obj, fbx, stl, usdz, 3mf

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

Begäran kunde inte godtas. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste anges.
• Saknad stil: En av text_style_prompt, image_style_url eller multiview_image_urls måste anges.
• Motstridiga stilinmatningar: multiview_image_urls kan inte kombineras med text_style_prompt eller image_style_url.
• Modell som inte stöds för flervy: multiview_image_urls kräver ett explicit ai_model: "meshy-7".
• Modell inte tillgänglig: ai_model: "meshy-7" och ai_model: "meshy-6-lite" rullas ut gradvis och kanske inte är aktiverade för ditt konto ännu.
• Ogiltig inmatningsuppgift: input_task_id måste hänvisa till en lyckad uppgift från en modell som stöds.
• Ogiltigt modellformat: model_url pekar på en fil med ett filtillägg som inte stöds.
• Oåtkomlig URL: model_url, image_style_url eller ett element i multiview_image_urls kunde inte hämtas.
• Modellfil för stor: Filen i model_url överstiger 400 MB (http- eller https-URL) eller 100 MB (data:-URI).
• För många polygoner: Filen i model_url är över 100 MB och har fler än 10 000 000 polygoner. Minska antalet polygoner och skicka 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 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: 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 igen.
• Bild för stor: Bilden i image_style_url eller ett element i multiview_image_urls överstiger 20 MB.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna uppgift.

Du har överskridit din hastighetsgräns.

Unik identifierare för den Omtextureringsuppgift som ska hämtas.

ID:t för den omtextureringsuppgift som ska tas bort.

Sidnummer för paginering.

Gräns för sidstorlek. 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 den omtextureringsuppgift 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 Retexture-uppgift. Värdet är retexture.

Nedladdningsbar URL till den texturerade 3D-modellfilen som genererats av Meshy.

Detta är textprompten som användes för att skapa textureringsuppgiften.

Detta är bildindatan som användes för att skapa textureringsuppgiften.

Nedladdningsbara URL:er till de flervy-referensbilder som användes för att skapa textureringsuppgiften. Finns endast med när uppgiften skapades med multiview_image_urls.

Nedladdningsbar URL till miniatyrbilden av modellfilen.

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

Förlopp för uppgiften. Om uppgiften inte har startat ännu är detta värde 0. När uppgiften har lyckats blir detta 100.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startat ännu är detta värde 0.

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

Tidsstämpel för när uppgiftens resultat upphör att gälla, i millisekunder.

Tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften inte är slutförd ännu är detta värde 0.

Status för uppgiften. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

En array med textur-URL-objekt som genereras från uppgiften. Vanligtvis innehåller denna endast ett textur-URL-objekt. Varje textur-URL har följande egenskaper:

Antalet föregående uppgifter.

Feldetaljer för misslyckade uppgifter. Se Fel för den fullständiga referensen för task_error-objektet.

Antalet credits som förbrukats av denna uppgift. Finns med när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).