Retexture API

Vereist, tenzij je model_url meestuurt. De ID van een taak die een te texturen 3D-model heeft opgeleverd, bijvoorbeeld een Tekst naar 3D-, Afbeelding naar 3D-, Remesh- of Retexture-taak. De taak moet er een zijn die je met de API hebt aangemaakt en de status SUCCEEDED hebben. Meshy textureert de GLB van de taak.

Met meshy-n1 mag het model van de taak maximaal 7.999.999 vlakken hebben, geteld als driehoeken (een vierhoek telt als 2).

Vereist, tenzij je input_task_id meestuurt. Het te texturen model, als een openbare URL of een data-URI. Als je beide meestuurt, gebruikt Meshy input_task_id.

Het model moet een GLB-, glTF-, OBJ-, FBX- of STL-bestand van maximaal 400 MB zijn vanaf een http- of https-URL, of 100 MB als data-URI. Gebruik voor een data-URI het MIME type application/octet-stream, bijvoorbeeld data:application/octet-stream;base64,<je base64-gecodeerde modeldata>.

Een bestand van meer dan 100 MB moet ook aan deze regels voldoen:

• Een GLB-, glTF-, FBX- of OBJ-bestand mag maximaal 10.000.000 vlakken hebben. Meshy telt vlakken als driehoeken, dus een vierhoek telt als 2, en een mesh die meerdere keren getekend wordt, telt één keer per kopie.
• Een FBX-bestand moet binaire FBX 7.1 of nieuwer zijn.
• Een GLB- of glTF-bestand mag geen Draco-compressie gebruiken.

Met meshy-n1 mag het model, ongeacht de bestandsgrootte, maximaal 7.999.999 vlakken hebben, geteld als driehoeken (een vierhoek telt als 2).

Vereist, tenzij je image_style_url of multiview_image_urls meestuurt. Tekst die de gewenste textuur beschrijft, tot 800 tekens. Langere tekst geeft 400 terug. Met meshy-n1 geeft het meesturen hiervan zonder image_style_url 400 terug.

Vereist, tenzij je text_style_prompt of multiview_image_urls meestuurt. Een 2D-afbeelding waarvan de stijl de textuur volgt, als een openbare URL of een data-URI (data:image/jpeg;base64,<je base64-gecodeerde afbeeldingsdata>). Als je zowel text_style_prompt als image_style_url meestuurt, gebruikt Meshy image_style_url.

De afbeelding moet een .jpg-, .jpeg-, .png- of .webp-bestand zijn van maximaal 20 MB en minstens 32 pixels aan elke zijde.

De textuur past mogelijk niet goed als het object in de afbeelding een heel andere vorm heeft dan het model. Met meshy-n1 behandelt Meshy de afbeelding als het vooraanzicht.

Vereist, tenzij je text_style_prompt of image_style_url meestuurt. Eén tot vier afbeeldingen van hetzelfde object vanuit verschillende aanzichten. De eerste afbeelding is het hoofd(voor)aanzicht. De volgorde van de andere aanzichten (links, achter, rechts) maakt niet uit. Een lege array, of meer dan vier afbeeldingen, geeft 400 terug.

Elke afbeelding volgt dezelfde formaat- en groottevereisten als image_style_url, maximaal 20 MB per afbeelding. Je kunt multiview_image_urls niet combineren met text_style_prompt of image_style_url.

multiview_image_urls vereist een expliciete ai_model van meshy-7 of meshy-n1. Elke andere ai_model, inclusief de standaard latest, geeft 400 terug.

Het AI-model dat de textuur genereert.

Beschikbare waarden:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: een 2K-basiskleurtextuur, alleen op basis van referentieafbeeldingen. Geen tekstprompt, geen PBR-maps, geen 4K of 8K. Tot 7.999.999 vlakken.
• latest: Meshy 7

Of de UV-layout van het model behouden blijft in plaats van er een nieuwe te genereren.

• Voor een model dat Meshy heeft gegenereerd, via input_task_id of een model_url die naar een Meshy-uitvoer verwijst, gebruik je true om de geoptimaliseerde UV-layout te hergebruiken.
• Voor een model dat je ergens anders vandaan hebt geüpload, gebruik je true om UV's te behouden die al goed zijn. Laat het op false staan om Meshy nieuwe UV's te laten genereren, wat geschikt is voor een model zonder goede UV-mapping.

Of er ook PBR-maps (metallic, roughness en normal) samen met de basiskleur worden gegenereerd. Met meshy-6 genereert Meshy ook een emissiemap, behalve bij een texture_resolution van 8k. meshy-6-lite, meshy-7 en latest genereren geen emissiemap. Met meshy-n1 geeft true 400 terug.

De grootte van de basiskleurtextuur. Hogere resoluties leggen meer oppervlaktedetail vast.

Beschikbare waarden:

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

4k en 8k vereisen een ai_model van meshy-6, meshy-7 of latest. Met meshy-6-lite of meshy-n1 geven ze 400 terug. Bij 8k genereert Meshy geen emissiemap.

Gebruik in plaats daarvan texture_resolution. true is hetzelfde als texture_resolution: "4k". Als je beide meestuurt, gebruikt Meshy texture_resolution.

Of hooglichten en schaduwen uit de basiskleurtextuur worden verwijderd. Het resultaat werkt beter onder je eigen belichting.

Meshy past dit alleen toe met meshy-6, bij een texture_resolution van 2k of 4k. Met meshy-7 of latest, of bij 8k, accepteert Meshy deze parameter en negeert hem. Met meshy-6-lite of meshy-n1 geeft het meesturen ervan, met welke waarde dan ook, 400 terug.

De te genereren bestandsformaten. Meshy genereert alleen de formaten die je opgeeft, wat de taak kan verkorten. Als je dit weglaat, genereert Meshy elk formaat behalve 3mf.

Beschikbare waarden:

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

Of er ook een voorbeeld met transparante achtergrond (RGBA) wordt gerenderd, teruggegeven in alpha_thumbnail_url wanneer je de taak opvraagt. thumbnail_url verandert niet.

Het verzoek kan niet worden uitgevoerd. Het foutbericht geeft aan welk probleem er is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: Noch model_url, noch input_task_id werd meegestuurd.
• Ontbrekende stijl: Geen van text_style_prompt, image_style_url en multiview_image_urls werd meegestuurd.
• Conflicterende stijlinvoeren: multiview_image_urls werd meegestuurd samen met text_style_prompt of image_style_url.
• Niet-ondersteund model voor meerdere aanzichten: multiview_image_urls werd meegestuurd zonder expliciete ai_model van meshy-7 of meshy-n1.
• Niet-ondersteunde optie voor Meshy N1: meshy-n1 werd meegestuurd met enable_pbr: true, remove_lighting, een texture_resolution van 4k of 8k, hd_texture: true zonder texture_resolution, of text_style_prompt zonder image_style_url.
• Te veel driehoeken voor Meshy N1: Met meshy-n1 heeft het 3D-model meer dan 7.999.999 driehoeken. Verlaag het aantal driehoeken of gebruik een ander ai_model.
• Model te complex voor Meshy N1: Met meshy-n1 is het model_url-bestand te complex voor Meshy om de driehoeken te tellen. Verlaag het aantal driehoeken en stuur het bestand opnieuw.
• Tellen van driehoeken time-out: Met meshy-n1 duurde het tellen van de driehoeken van het model_url-bestand te lang. Probeer het opnieuw of verklein het model.
• Ongeldige invoertaak: input_task_id is geen geslaagde taak van een ondersteund type.
• Ongeldig modelformaat: Het model_url-bestand heeft een niet-ondersteunde extensie.
• Onbereikbare URL: Meshy kan het model_url-bestand, de image_style_url-afbeelding of een multiview_image_urls-afbeelding niet downloaden.
• Modelbestand te groot: Het model_url-bestand is groter dan 400 MB vanaf een http- of https-URL, of groter dan 100 MB als data-URI.
• Te veel vlakken: Het model_url-bestand is groter dan 100 MB en heeft meer dan 10.000.000 vlakken. Verlaag het aantal vlakken en stuur het bestand opnieuw.
• ASCII-FBX groter dan 100 MB: Het model_url-bestand is een ASCII-FBX groter dan 100 MB. Stuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: Het model_url-bestand is groter dan 100 MB en Meshy kan de header niet lezen. Bijvoorbeeld een Draco-gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: Het model_url-bestand is groter dan 100 MB en de header bevat te veel meshes, nodes of records om te controleren. Verlaag het aantal objecten in het bestand en stuur het opnieuw.
• Afbeelding te groot: De image_style_url-afbeelding of een multiview_image_urls-afbeelding is groter dan 20 MB.

Met meshy-n1 wordt een model dat Meshy niet kan controleren voordat de taak start, zoals een STL-bestand, hier niet geweigerd. Als het meer dan 7.999.999 driehoeken heeft, mislukt de taak en vergoedt Meshy de credits.

Herstel het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft niet genoeg credits voor deze taak, of het account heeft een creditlimiet bereikt. Controleer je creditsaldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade je abonnement in je abonnementsinstellingen en probeer het opnieuw.

Een van deze situaties is van toepassing:

• Contentmoderatie heeft de prompt of een invoerafbeelding geblokkeerd. Wijzig de invoer en probeer het opnieuw.
• input_task_id is een bas-reliëfmodel, dat deze endpoint niet kan hertextureren. Het bericht is This model type does not support this operation. Stuur een ander model.

input_task_id komt met geen van je taken overeen. Controleer de taak-ID en stuur het verzoek opnieuw.

Je hebt je rate limit overschreden. Wacht en probeer het opnieuw. Zie Rate limits.

De taak-ID uit de respons van het aanmaakverzoek.

De ID van de te verwijderen taak.

Het paginanummer dat moet worden geretourneerd, tot 255. Een grotere waarde geeft 400 terug.

Het aantal taken per pagina, tot 100.

De sorteervolgorde.

Beschikbare waarden:

• +created_at: oudste eerst
• -created_at: nieuwste eerst

De taak-ID uit de create-respons.

De taak-ID. Behandel dit als een ondoorzichtige string en vertrouw niet op het formaat ervan.

Het taaktype, altijd retexture.

Download-URL's voor het getextureerde 3D-model, één per bestandsformaat.

De tekstprompt waarmee je de taak hebt aangemaakt.

De stijlafbeelding waarmee je de taak hebt aangemaakt.

Download-URL's voor de referentieafbeeldingen met meerdere aanzichten waarmee je de taak hebt aangemaakt. Alleen aanwezig wanneer je de taak hebt aangemaakt met multiview_image_urls.

Download-URL voor een thumbnail-afbeelding van het model.

Download-URL voor een versie van thumbnail_url met een transparante achtergrond (RGBA). Alleen aanwezig wanneer je de taak hebt aangemaakt met alpha_thumbnail: true en Meshy de transparante voorvertoning heeft gerenderd.

Hoeveel van de taak klaar is, als percentage. Dit is 0 totdat de taak start en 100 wanneer deze slaagt.

Tijdstip waarop de taak is gestart, in Unix-milliseconden. Dit is 0 totdat de taak start.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop de resultaten van de taak verlopen, in Unix-milliseconden.

Tijdstip waarop de taak is voltooid, in Unix-milliseconden. Dit is 0 totdat de taak voltooid is.

De taakstatus, één van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, of CANCELED.

Download-URL's voor de gegenereerde texturen, als een array van objecten. De array bevat meestal één object. Elk object heeft de volgende velden:

Het aantal taken dat vóór deze taak in de wachtrij staat. Alleen aanwezig terwijl de taak PENDING is; het veld wordt weggelaten wanneer de waarde 0 is.

De foutdetails wanneer de taak mislukt. Zie Fouten.

Het aantal credits dat de taak heeft gebruikt. Aanwezig wanneer de status PENDING, IN_PROGRESS, of SUCCEEDED is. Dit is 0 voor een FAILED-taak, omdat Meshy de credits terugbetaalt wanneer een taak mislukt.