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.

Geef het type 3D-mesh-generatie op.

Beschikbare waarden:

• standard: Reguliere 3D-mesh-generatie met hoog detailniveau.
• smart-topology: Kies een Smart Topology-model met ai_model (meshy-t2 of meshy-t2.5).
• lowpoly (verouderd, wordt stopgezet op 30 oktober 2026): Genereert low-poly mesh geoptimaliseerd voor schonere polygonen. We raden in plaats daarvan Meshy T2.5 aan: smart-topology met meshy-t2.5.

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

Standaardgeneratie (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (verouderd): gebruik in plaats daarvan meshy-7.1.

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

• meshy-t2: het Smart Topology-model — schonere topology, van nature gescheiden onderdelen, triangle-output, en een polygoonaantal dat u kunt instellen met target_polycount.
• meshy-t2.5 (standaard): Scherper detail voor game-assets. Triangle-output, en een polygoonaantal dat u kunt instellen met target_polycount.

Geometrie-generatiepas. 2k voert de Ultra-pas uit op 2048³; 4k voert deze uit op 4096³ voor het fijnste oppervlaktedetail.

Beschikbare waarden: standard, 2k, 4k

Gebruik in plaats daarvan geometry_resolution. ultra_mode: true is gelijkwaardig aan geometry_resolution: "2k".

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

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

target_polycount heeft effect in twee onafhankelijke gevallen:

• Remesh — met should_remesh: true op een standard-model. De mesh wordt geremesht (gedecimeerd) 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 of meshy-t2.5. Het model wordt direct gegenereerd met dit aantal faces; er wordt geen remesh uitgevoerd en should_remesh is niet vereist. Voor meshy-t2: bereik 100 tot 15.000, standaard 4.000. Voor meshy-t2.5: bereik 100 tot 30.000, standaard 15.000.

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

Het veld symmetry_mode bepaalt het symmetriegedrag tijdens het modelgeneratieproces.

De geldige waarden zijn:

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

Geef de pose-mode op 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. Verzoeken 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 generatie.

De tekst uit prompt wordt gescreend.

Geeft aan welke 3D-bestandsformaten in de output moeten worden opgenomen. Alleen de opgevraagde formaten worden gegenereerd en geretourneerd, wat de taakvoltooiingstijd kan verkorten. Indien 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 werkelijke hoogte van het object te schatten en het model dienovereenkomstig in formaat te wijzigen. De oorsprong wordt standaard bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Een vereiste parameter (bijv. prompt, mode) ontbreekt.
• Ongeldige parameter: art_style is geen van de toegestane waarden.
• Prompt te lang: De prompt overschrijdt de tekenlimiet.
• Niet-ondersteund model voor low poly: ai_model: "meshy-6-lite" ondersteunt model_type: "lowpoly" niet.
• Niet-ondersteund model voor Ultra: geometry_resolution vereist meshy-7.1 of latest.

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

U heeft uw 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. Er wordt ook een emission map toegevoegd wanneer ai_model meshy-6 is, behalve bij texture_resolution: 8k (er wordt geen emission map geproduceerd). meshy-6-lite, meshy-7.1 en latest produceren geen emission map, en dat geldt ook voor een refine van een meshy-t2-preview waarbij ai_model niet is ingesteld.

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 — gelijk aan texture_resolution: "4k". Als beide zijn ingesteld, heeft texture_resolution voorrang.

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

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

Maximale bestandsgrootte: 20 MB.

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,<uw base64-gecodeerde afbeeldingsgegevens>

ID van het model dat moet worden gebruikt voor refine.

Beschikbare waarden:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (verouderd): gebruik in plaats daarvan meshy-7.1.

Laat deze parameter weg om het model over te nemen dat door de preview-taak is gebruikt, zodat een preview en de bijbehorende refine van begin tot eind op hetzelfde model blijven. Geef een expliciete waarde op om die overerving te overschrijven.

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

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

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

Geeft aan 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. Indien weggelaten, worden alle ondersteunde formaten opgenomen.

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

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

Als dit is 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 is standaard bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ongeldige taak-ID: De preview_task_id is ongeldig of bestaat niet.
• Taak nog niet klaar: De preview-taak is nog niet geslaagd.
• Modelmismatch: Het AI-model van de preview-taak is niet compatibel met het aangevraagde refine-model.
• Niet-ondersteund model voor remove_lighting: remove_lighting is ingesteld met ai_model: "meshy-6-lite".

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De preview-taak opgegeven door preview_task_id is niet gevonden.

U heeft uw rate limit overschreden.

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

De ID van de Tekst naar 3D-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 identificatie voor de Tekst naar 3D-taak die gestreamd moet worden.

Unieke identifier voor de taak. Hoewel we een k-sortable UUID gebruiken voor task-id's als implementatiedetail, mag je geen aannames doen over de indeling 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 is gebruikt om de taak aan te maken.

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

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

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

Verouderd; raadpleeg in plaats daarvan geometry_resolution.

De Ultra-tier waarop de preview-taak is uitgevoerd (2k of 4k); weggelaten voor standard.

Downloadbare URL naar de textuurafbeelding die is 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 is 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 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. Retourneert 0 voor FAILED-taken (credits worden bij mislukking terugbetaald).