Tekst naar 3D API

Dit veld moet worden ingesteld op "preview" bij het aanmaken van een preview-taak.

Beschrijf wat voor soort object het 3D-model is. Maximaal 800 tekens.

Specificeer het type 3D-mesh-generatie.

Beschikbare waarden:

• standard: Reguliere 3D-mesh-generatie met hoog detailniveau.
• smart-topology: Kies het Smart Topology-model met ai_model (meshy-t2).
• lowpoly (verouderd): Genereert een low-poly mesh geoptimaliseerd voor schonere polygonen. We raden aan smart-topology te gebruiken.

ID van het te gebruiken model. De beschikbare waarden zijn afhankelijk van model_type.

Standaardgeneratie (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Smart Topology-generatie (model_type: smart-topology):

• meshy-t2 (standaard): het Smart Topology-model — schonere topology, van nature gescheiden onderdelen, triangle-output en een polygonaantal dat je kunt instellen met target_polycount.

Schakelt Ultra-generatie in voor geometrie met een hogere getrouwheid en fijnere oppervlaktedetails. Genereren duurt langer en kost 5 extra credits.

Bepaalt of de remesh-fase wordt ingeschakeld. Voor het model met de hoogste kwaliteit raden we aan should_remesh op false te zetten.

Beoogd aantal polygonen (vlakken) in de output. Het werkelijke aantal kan afwijken van het doel, afhankelijk van de geometrie.

target_polycount heeft in twee onafhankelijke gevallen effect:

• Remesh — met should_remesh: true op een standard-model. De mesh wordt geremesht (gereduceerd) tot ongeveer dit aantal. Bereik 100 tot 300.000, standaard 30.000. Als decimation_mode is ingesteld, heeft dit prioriteit en wordt target_polycount genegeerd.
• Smart Topology — met model_type: smart-topology en ai_model: meshy-t2. Het model wordt direct met dit polygonaantal gegenereerd; er wordt geen remesh uitgevoerd en should_remesh is niet vereist. Bereik 100 tot 15.000, standaard 4.000.

Verouderd. Deze parameter heeft geen effect meer op de output.

Het symmetry_mode-veld bepaalt het symmetriegedrag tijdens het genereren van het model.

De geldige waarden zijn:

• off: Schakelt symmetrie uit.
• auto: Bepaalt en past automatisch symmetrie toe op basis van de invoergeometrie.
• on: Dwingt symmetrie af tijdens het genereren.

Specificeer de pose_mode voor het gegenereerde model.

Beschikbare waarden:

• a-pose: Genereert het model in een A-pose.
• t-pose: Genereert het model in een T-pose.
• "" (lege string): Geen specifieke pose toegepast.

Gebruik in plaats daarvan pose_mode. Of het model in een A/T-pose moet worden gegenereerd.

Niet ondersteund door Meshy-6. Aanvragen met Meshy-6 negeren art_style, en sommige combinaties kunnen fouten veroorzaken. Beschikbare waarden: realistic, sculpture.

Wanneer ingesteld op true, wordt de invoerinhoud automatisch gescreend op mogelijk schadelijke inhoud. Als schadelijke inhoud wordt gedetecteerd, gaat de taak niet door naar de generatiefase.

De tekst uit prompt wordt gescreend.

Specificeert welke 3D-bestandsformaten in de output moeten worden opgenomen. Alleen de opgevraagde formaten worden gegenereerd en geretourneerd, wat de doorlooptijd van de taak kan verkorten. Indien weggelaten, worden alle ondersteunde formaten opgenomen.

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

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

Wanneer ingesteld op true, gebruikt de service AI-vision om automatisch de werkelijke hoogte van het object te schatten en het model dienovereenkomstig van formaat te wijzigen. De oorsprong wordt standaard op bottom gezet, tenzij origin_at expliciet is ingesteld.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Een verplichte parameter (bijv. prompt, mode) ontbreekt.
• Ongeldige parameter: art_style is niet een van de toegestane waarden.
• Prompt te lang: De prompt overschrijdt de tekenlimiet.

Authenticatie is mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

Je hebt je rate limit overschreden.

Dit veld moet worden ingesteld op "refine" bij het aanmaken van een refine-taak.

De bijbehorende preview-taak-id.

De status van de opgegeven preview-taak moet SUCCEEDED zijn.

Genereer PBR-maps (metallic, roughness, normal) naast de basiskleur. Een emissiemap wordt ook meegeleverd wanneer ai_model meshy-6 is, behalve bij texture_resolution: 8k (er wordt geen emissiemap geproduceerd). meshy-7 (en latest) produceert geen emissiemap.

Resolutie van de basiskleurtextuur. Een van 2k (2048×2048), 4k (4096×4096) of 8k (8192×8192). Hogere resoluties leggen meer oppervlaktedetail vast. Geldt alleen voor de refine-mode.

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

Geef een aanvullende tekstprompt op om het textureringsproces te begeleiden. Maximaal 800 tekens.

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

Er zijn twee manieren om de afbeelding op te geven:

• 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,<your base64-encoded image data>

ID van het te gebruiken model voor refine. Beschikbare waarden: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Wanneer ingesteld op true, wordt de invoerinhoud automatisch gescreend op mogelijk schadelijke inhoud. Als schadelijke inhoud wordt gedetecteerd, gaat de taak niet verder naar generatie.

Zowel de tekst van texture_prompt als de afbeelding van texture_image_url worden gescreend.

Verwijdert lichtaccenten en schaduwen uit de basiskleurtextuur, wat een schoner resultaat oplevert dat beter werkt onder aangepaste lichtopstellingen.

Specificeert welke 3D-bestandsformaten in de uitvoer moeten worden opgenomen. Alleen de aangevraagde formaten worden gegenereerd en geretourneerd, wat de voltooiingstijd van de taak kan verkorten. Wanneer weggelaten, worden alle ondersteunde formaten opgenomen.

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

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

Wanneer ingesteld op true, gebruikt de service AI-visie om automatisch de reële hoogte van het object te schatten en het model dienovereenkomstig aan te passen. De oorsprong staat standaard op bottom tenzij origin_at expliciet is ingesteld.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ongeldige taak-ID: De preview_task_id is ongeldig of bestaat niet.
• Taak nog niet gereed: De preview-taak is nog niet geslaagd.
• Modelmismatch: Het AI-model van de preview-taak is niet compatibel met het aangevraagde refine-model.

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De preview-taak die is opgegeven via preview_task_id is niet gevonden.

U heeft uw rate limit overschreden.

Unieke identificatie voor de Tekst naar 3D-taak die moet worden opgehaald.

De ID van de Tekst naar 3D-taak die u wilt verwijderen.

Paginanummer voor paginering.

Paginagrootte-limiet. Maximaal toegestaan is 50 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 Tekst naar 3D-taak die gestreamd moet worden.

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

Type van de Text to 3D-taak. Mogelijke waarden zijn text-to-3d-preview voor taken in de preview-fase en text-to-3d-refine voor taken in de refine-fase.

Downloadbare URL naar het getextureerde 3D-modelbestand dat door Meshy is gegenereerd. De eigenschap voor een formaat wordt weggelaten als het formaat niet is gegenereerd, in plaats van een lege string te retourneren.

Dit is de ongewijzigde prompt die werd gebruikt om de taak aan te maken.

Onderhouden voor achterwaartse compatibiliteit. Dit veld heeft geen functionele invloed op gegenereerde modellen.

De ongewijzigde art_style die werd gebruikt om de preview-taak aan te maken. Niet ondersteund door Meshy-6.

Onderhouden voor achterwaartse compatibiliteit. Dit veld heeft geen functionele invloed op gegenereerde modellen.

Aanvullende tekstprompt die wordt gebruikt om het textureringsproces tijdens de refine-fase te sturen.

Geeft de ultra_mode-waarde weer waarmee de preview-taak werd aangemaakt. Alleen aanwezig voor meshy-7 (of latest) preview-taken die expliciet ultra_mode hebben ingesteld; anders weggelaten.

Downloadbare URL naar de textuurafbeelding die werd gebruikt om het textureringsproces te sturen.

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 werd aangemaakt met alpha_thumbnail: true en de transparante preview succesvol is gerenderd; anders wordt dit veld weggelaten.

Downloadbare URL naar de previewvideo. Wordt in een toekomstige release verwijderd.

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 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 voorgaande 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. Retourneert 0 voor FAILED-taken (credits worden terugbetaald bij een mislukking).