Retexture API

Krävs om du inte skickar model_url. ID:t för en uppgift som har gett en 3D-modell att texturera, till exempel en Text till 3D-, Bild till 3D-, Remesh- eller Omtexturering-uppgift. Uppgiften måste vara en du skapat med API:et och ha statusen SUCCEEDED. Meshy texturerar uppgiftens GLB.

Med meshy-n1 kan uppgiftens modell ha som mest 7 999 999 ytor, räknat som trianglar (en fyrhörning räknas som 2).

Krävs om du inte skickar input_task_id. Modellen att texturera, 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-, glTF-, OBJ-, FBX- eller STL-fil på högst 400 MB från en http- eller https-URL, eller 100 MB som en data-URI. För en data-URI, använd MIME type application/octet-stream, till exempel data:application/octet-stream;base64,<dina base64-kodade modelldata>.

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

• En GLB-, glTF-, FBX- eller OBJ-fil kan ha som mest 10 000 000 ytor. Meshy räknar ytor som trianglar, så en fyrhörning 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.

Med meshy-n1 kan modellen ha som mest 7 999 999 ytor, räknat som trianglar (en fyrhörning räknas som 2), oavsett filstorlek.

Krävs om du inte skickar image_style_url eller multiview_image_urls. Text som beskriver texturen du vill ha, upp till 800 tecken. Längre text returnerar 400. Med meshy-n1, att skicka den utan image_style_url returnerar 400.

Krävs om du inte skickar text_style_prompt eller multiview_image_urls. En 2D-bild vars stil texturen följer, som en offentlig URL eller en data-URI (data:image/jpeg;base64,<dina base64-kodade bilddata>). Om du skickar både text_style_prompt och image_style_url använder Meshy image_style_url.

Bilden måste vara en .jpg-, .jpeg-, .png- eller .webp-fil på högst 20 MB, och minst 32 pixlar på varje sida.

Texturen kanske inte passar bra när objektet i bilden har en mycket annorlunda form än modellen. Med meshy-n1 behandlar Meshy bilden som framvyn.

Krävs om du inte skickar text_style_prompt eller image_style_url. En till fyra bilder av samma objekt från olika vinklar. Den första bilden är huvudvyn (framvyn). Ordningen på de andra vyerna (vänster, bak, höger) spelar ingen roll. En tom array, eller fler än fyra bilder, returnerar 400.

Varje bild följer samma format- och storleksregler som image_style_url, högst 20 MB per bild. Du kan inte kombinera multiview_image_urls med text_style_prompt eller image_style_url.

multiview_image_urls kräver en uttrycklig ai_model på meshy-7 eller meshy-n1. Varje annan ai_model, inklusive standardvärdet latest, returnerar 400.

AI-modellen som genererar texturen.

Tillgängliga värden:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: en 2K grundfärgstextur enbart från referensbilder. Ingen textprompt, inga PBR-mappar, ingen 4K eller 8K. Upp till 7 999 999 ytor.
• latest: Meshy 7

Om modellens UV-layout ska behållas istället för att generera en ny.

• För en modell Meshy genererat, från input_task_id eller en model_url som pekar på en Meshy-utdata, använd true för att återanvända dess optimerade UV-layout.
• För en modell du laddade upp från någon annanstans, använd true för att behålla UV:er som redan är bra. Lämna det som false för att låta Meshy generera nya UV:er, vilket passar en modell utan korrekt UV-mappning.

Om PBR-mappar (metallic, roughness och normal) också ska genereras tillsammans med grundfärgen. Med meshy-6 genererar Meshy även en emissionsmapp, förutom vid en texture_resolution på 8k. meshy-6-lite, meshy-7 och latest genererar inte någon emissionsmapp. Med meshy-n1 returnerar true 400.

Storleken på grundfärgstexturen. Högre upplösningar fångar fler ytdetaljer.

Tillgängliga värden:

• 2k: 2048 × 2048 pixlar
• 4k: 4096 × 4096 pixlar
• 8k: 8192 × 8192 pixlar

4k och 8k kräver en ai_model på meshy-6, meshy-7 eller latest. Med meshy-6-lite eller meshy-n1 returnerar de 400. Vid 8k genererar Meshy inte någon emissionsmapp.

Använd texture_resolution istället. true är detsamma som texture_resolution: "4k". Om du skickar båda använder Meshy texture_resolution.

Om highlights och skuggor ska tas bort från grundfärgstexturen. Resultatet fungerar bättre under din egen belysning.

Meshy tillämpar det endast med meshy-6, vid en texture_resolution på 2k eller 4k. Med meshy-7 eller latest, eller vid 8k, accepterar Meshy det och ignorerar det. Med meshy-6-lite eller meshy-n1 returnerar det 400 oavsett vilket värde som skickas.

Filformaten som ska genereras. Meshy genererar endast formaten du listar, vilket kan korta ner uppgiften. Om du utelämnar det genererar Meshy alla format utom 3mf.

Tillgängliga värden:

• glb
• obj
• fbx
• stl
• usdz
• 3mf

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

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

• Saknad parameter: Varken model_url eller input_task_id skickades.
• Saknad stil: Ingen av text_style_prompt, image_style_url och multiview_image_urls skickades.
• Motstridiga stilindata: multiview_image_urls skickades med text_style_prompt eller image_style_url.
• Modell som inte stöds för flervy: multiview_image_urls skickades utan en uttrycklig ai_model på meshy-7 eller meshy-n1.
• Alternativ som inte stöds för Meshy N1: meshy-n1 skickades med enable_pbr: true, remove_lighting, en texture_resolution på 4k eller 8k, hd_texture: true utan texture_resolution, eller text_style_prompt utan image_style_url.
• För många trianglar för Meshy N1: Med meshy-n1 har 3D-modellen fler än 7 999 999 trianglar. Minska antalet trianglar, eller använd en annan ai_model.
• Modell för komplex för Meshy N1: Med meshy-n1 är model_url-filen för komplex för att Meshy ska kunna räkna dess trianglar. Minska antalet trianglar, skicka sedan filen igen.
• Triangelräkning fick timeout: Med meshy-n1 tog det för lång tid att räkna trianglarna i model_url-filen. Försök igen, eller minska modellens storlek.
• Ogiltig indatauppgift: input_task_id är inte en lyckad uppgift av en typ som stöds.
• Ogiltigt modellformat: model_url-filen har ett filtillägg som inte stöds.
• Onåbar URL: Meshy kan inte ladda ner model_url-filen, image_style_url-bilden eller en multiview_image_urls-bild.
• 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, skicka sedan filen igen.
• ASCII-FBX över 100 MB: model_url-filen är en ASCII-FBX över 100 MB. Skicka den som binär FBX eller GLB.
• Oläsbar modellfil: model_url-filen ä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.
• 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, skicka sedan den igen.
• Bild för stor: image_style_url-bilden eller en multiview_image_urls-bild är över 20 MB.

Med meshy-n1 avvisas inte en modell som Meshy inte kan kontrollera innan uppgiften startar, till exempel en STL-fil, här. Om den har fler än 7 999 999 trianglar misslyckas uppgiften, och Meshy återbetalar dess credits.

Åtgärda begäran, 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, försök sedan igen.
• Gratisplan: Att skapa en uppgift kräver en betald plan. Uppgradera din plan i dina prenumerationsinställningar, försök sedan igen.

Ett av följande gäller:

• Innehållsmoderering blockerade prompten eller en indatabild. Ändra indata, försök sedan igen.
• input_task_id är en basreliefmodell, som denna endpoint inte kan omtexturera. Meddelandet är This model type does not support this operation. Skicka en annan modell.

input_task_id matchar ingen av dina uppgifter. Kontrollera uppgifts-ID:t, skicka sedan begäran igen.

Du har överskridit din hastighetsgräns. Vänta, försök sedan igen. Se Hastighetsgränser.

Uppgifts-ID från svaret vid skapandet.

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

Sidnumret som ska returneras, upp till 255. Ett högre värde returnerar 400.

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 skapandesvaret.

Task-ID:t. Behandla det som en ogenomskinlig sträng och förlita dig inte på dess format.

Tasktypen, alltid retexture.

Nedladdnings-URL:er för den texturerade 3D-modellen, en per filformat.

Textprompten du skapade tasken med.

Stilbilden du skapade tasken med.

Nedladdnings-URL:er för Flervy-referensbilderna du skapade tasken med. Finns endast med när du skapade tasken med multiview_image_urls.

Nedladdnings-URL för en miniatyrbild av modellen.

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

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

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

Tidpunkten då tasken skapades, i Unix-millisekunder.

Tidpunkten då taskens resultat upphör att gälla, i Unix-millisekunder.

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

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

Nedladdnings-URL:er för de genererade texturerna, som en array av objekt. Arrayen innehåller vanligtvis ett objekt. Varje objekt har dessa fält:

Antalet tasks före denna i kön. Finns endast med medan tasken är PENDING; fältet utelämnas när värdet är 0.

Feldetaljerna när tasken misslyckas. Se Fel.

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