Retexture API

De ID van de voltooide Afbeelding naar 3D- of Tekst naar 3D-taak die je opnieuw van textuur wilt voorzien. Deze taak moet een van de volgende taken zijn: Text to 3D Preview, Text to 3D Refine, Image to 3D of Remesh. Daarnaast moet de status SUCCEEDED zijn.

Geef een 3D-model op dat Meshy moet textureren. Ondersteunde formaten: .glb, .gltf, .obj, .fbx, .stl.

Maximale bestandsgrootte: 400 MB voor een http- of https-URL, 100 MB voor een data:-URI.

Een GLB-, glTF-, FBX- of OBJ-bestand groter dan 100 MB mag maximaal 10.000.000 faces bevatten. Faces worden geteld als driehoeken: een vierhoek telt als 2, en een mesh die meerdere keren getekend wordt telt per kopie één keer. Boven 100 MB moet een FBX-bestand binaire FBX 7.1 of nieuwer zijn, en mag een GLB- of glTF-bestand geen Draco-compressie gebruiken.

Er zijn twee manieren om het model aan te leveren:

• Publiek toegankelijke URL: Een URL die toegankelijk is vanaf het openbare internet.
• Data URI: Een base64-gecodeerde data-URI van het model. Gebruik MIME type application/octet-stream. Voorbeeld: data:application/octet-stream;base64,<je base64-gecodeerde modelgegevens>.

Beschrijf de gewenste textuurstijl van het object met tekst. Maximaal 800 tekens.

Geef een 2D-afbeelding op om het textureerproces te sturen. We ondersteunen momenteel de formaten .jpg, .jpeg, .png en .webp.

Maximale bestandsgrootte: 20 MB.

Er zijn twee manieren om de afbeelding aan te leveren:

• Publiek toegankelijke URL: Een URL die toegankelijk is vanaf het openbare internet
• Data URI: Een base64-gecodeerde data-URI van de afbeelding. Voorbeeld van een data-URI: data:image/jpeg;base64,<je base64-gecodeerde afbeeldingsgegevens>

Geef 1 tot 4 afbeeldingen op die hetzelfde object vanuit verschillende hoeken tonen om het textureren te sturen. De eerste afbeelding is het primaire (voor)aanzicht; de volgorde van de overige aanzichten (links, achter, rechts) maakt niet uit.

Elk element accepteert dezelfde formaten als image_style_url (een publiek toegankelijke URL of een base64 data-URI, .jpg/.jpeg/.png/.webp).

Maximale bestandsgrootte: 20 MB per afbeelding.

ID van het AI-model dat gebruikt wordt voor het hertextureren. Beschikbare waarden: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Behoud de bestaande UV-layout van het model in plaats van een nieuwe te genereren.

• Als je een model hertextureert dat door Meshy is gegenereerd (via input_task_id, of een model_url die naar een Meshy-uitvoer verwijst), zet dit dan op true om de geoptimaliseerde UV-layout opnieuw te gebruiken.
• Als je een door jou geüpload model van een derde partij hertextureert, zet dit op true wanneer het al goede UV's heeft die je wilt behouden, of laat het op false staan zodat Meshy nieuwe UV's uitvouwt (het beste voor modellen zonder goede UV-mapping).

Genereer PBR-maps (metallic, roughness, normal) naast de basiskleur. Er wordt ook een emission map meegeleverd wanneer ai_model meshy-6 is, behalve bij texture_resolution: 8k. meshy-6-lite, meshy-7 en latest produceren geen emission map.

Resolutie van de basiskleurtextuur. Een van 2k (2048×2048), 4k (4096×4096), of 8k (8192×8192). Hogere resoluties leggen meer oppervlaktedetails vast.

Gebruik in plaats daarvan texture_resolution — gelijk aan texture_resolution: "4k". Wanneer beide zijn ingesteld, heeft texture_resolution voorrang.

Verwijdert lichtvlekken en schaduwen uit de basiskleurtextuur, wat een schoner resultaat oplevert dat beter werkt bij aangepaste belichtingsopstellingen.

Specificeert welke 3D-bestandsformaten in de uitvoer moeten worden opgenomen. Alleen de gevraagde formaten worden gegenereerd en geretourneerd, wat de taakverwerkingstijd kan verkorten. Indien weggelaten, worden alle ondersteunde formaten opgenomen.

Beschikbare waarden: glb, obj, fbx, stl, usdz, 3mf

Wanneer ingesteld op true, rendert de taak extra een versie van de preview met een transparante achtergrond (RGBA) en retourneert deze als alpha_thumbnail_url in het GET-antwoord. Het bestaande veld thumbnail_url blijft ongewijzigd.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Ofwel model_url ofwel input_task_id moet worden opgegeven.
• Ontbrekende stijl: Een van text_style_prompt, image_style_url of multiview_image_urls moet worden opgegeven.
• Conflicterende stijlinvoer: multiview_image_urls kan niet worden gecombineerd met text_style_prompt of image_style_url.
• Niet-ondersteund model voor meerdere aanzichten: multiview_image_urls vereist een expliciete ai_model: "meshy-7".
• Model niet beschikbaar: ai_model: "meshy-7" en ai_model: "meshy-6-lite" worden geleidelijk uitgerold en zijn mogelijk nog niet ingeschakeld voor jouw account.
• Ongeldige invoertaak: De input_task_id moet verwijzen naar een succesvolle taak van een ondersteund model.
• Ongeldig modelformaat: De model_url verwijst naar een bestand met een niet-ondersteunde extensie.
• Onbereikbare URL: De model_url, image_style_url of een element van multiview_image_urls kon niet worden gedownload.
• Modelbestand te groot: Het bestand van model_url overschrijdt 400 MB (http- of https-URL) of 100 MB (data:-URI).
• Te veel faces: Het bestand van model_url is groter dan 100 MB en heeft meer dan 10.000.000 faces. Verminder het aantal faces en stuur het bestand opnieuw.
• ASCII FBX boven 100 MB: Het bestand van model_url is een ASCII FBX groter dan 100 MB. Stuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: Het bestand van model_url is groter dan 100 MB en de header kan niet worden gelezen, bijvoorbeeld een met Draco gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: Het bestand van model_url is groter dan 100 MB en de header heeft te veel meshes, nodes of records om te controleren. Verminder het aantal objecten in het bestand en stuur het opnieuw.
• Afbeelding te groot: De afbeelding van image_style_url of een element van multiview_image_urls overschrijdt 20 MB.

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

Je hebt je rate limit overschreden.

Unieke identificatie van de op te halen Retexture-taak.

De ID van de Hertextureren-taak die moet worden verwijderd.

Paginanummer voor paginering.

Paginagrootte-limiet. Maximaal toegestaan is 100 items.

Veld om op te sorteren.

Beschikbare waarden:

• +created_at: Sorteer op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteer op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de Hertextuur-taak die gestreamd moet worden.

Unieke identifier voor de taak. Hoewel we als implementatiedetail een k-sortable UUID gebruiken voor task-id's, mag je geen aannames doen over de indeling van de id.

Type van de Retexture-taak. De waarde is retexture.

Downloadbare URL naar het getextureerde 3D-modelbestand dat door Meshy is gegenereerd.

Dit is de tekst-prompt die is gebruikt om de textureertaak te maken.

Dit is de afbeeldingsinvoer die is gebruikt om de textureertaak te maken.

Downloadbare URL's naar de Meerdere aanzichten-referentieafbeeldingen die zijn gebruikt om de textureertaak te maken. Alleen aanwezig wanneer de taak is aangemaakt met multiview_image_urls.

Downloadbare URL naar de thumbnail-afbeelding van het modelbestand.

Downloadbare URL naar een versie van thumbnail_url met transparante achtergrond (RGBA). Alleen aanwezig wanneer de taak is aangemaakt met alpha_thumbnail: true en de transparante preview succesvol is gerenderd; anders wordt dit veld weggelaten.

Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

Tijdstempel van wanneer het taakresultaat verloopt, in milliseconden.

Tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap 0.

Status van de taak. Mogelijke waarden zijn een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Een array van textuur-URL-objecten die door de taak zijn gegenereerd. Normaal gesproken bevat dit slechts één textuur-URL-object. Elke textuur-URL heeft de volgende eigenschappen:

Het aantal voorafgaande taken.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

Het aantal credits dat door deze taak is verbruikt. Aanwezig wanneer de taakstatus PENDING, IN_PROGRESS of SUCCEEDED is. Geeft 0 terug voor FAILED-taken (credits worden terugbetaald bij een mislukking).