Tekst naar 3D API

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

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

Specificeer het type 3D mesh-generatie.

Beschikbare waarden:

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

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

Standaard generatie (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, inheemse gescheiden delen, driehoekuitvoer, en een aantal gezichten dat je kunt instellen met target_polycount.

Schakelt Ultra-generatie in voor hogere getrouwheidsgeometrie met fijnere oppervlakte-detail. Generatie duurt langer en voegt 5 credits toe.

Bepaalt of de remesh fase ingeschakeld moet worden. Voor het hoogste-kwaliteitmodel raden we aan should_remesh in te stellen op false.

Gewenst aantal polygonen (vlakken) in de uitvoer. Het werkelijke aantal kan afwijken van de doelstelling, 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) naar ongeveer dit aantal. Bereik 100 tot 300.000, standaard 30.000. Als decimation_mode is ingesteld, krijgt dit voorrang en wordt target_polycount genegeerd.
• Smart Topology — met model_type: smart-topology en ai_model: meshy-t2. Het model wordt direct bij dit gezichtsgetal gegenereerd; geen remesh wordt uitgevoerd en should_remesh is niet vereist. Bereik 100 tot 15.000, standaard 4.000.

Verouderd. Deze parameter beïnvloedt de uitvoer niet meer.

Het symmetry_mode veld regelt het symmetriegedrag tijdens het modelgeneratieproces.

De geldige waarden zijn:

• off: Schakelt symmetrie uit.
• auto: Bepaalt automatisch en past symmetrie toe op basis van invoergeometrie.
• on: Handhaaft symmetrie tijdens de generatie.

Specificeer de pose mode voor het gegenereerde model.

Beschikbare waarden:

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

Gebruik pose_mode in plaats daarvan. 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 potentieel schadelijke inhoud. Als schadelijke inhoud wordt gedetecteerd, zal de taak niet doorgaan naar generatie.

De tekst uit prompt zal worden gescreend.

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

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

Wanneer ingesteld op true, renderert de taak ook een transparante achtergrond (RGBA) versie van de preview en retourneert deze als alpha_thumbnail_url in de GET-reactie. Het bestaande thumbnail_url veld 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 te schalen. De oorsprong zal standaard naar bottom gaan, tenzij origin_at expliciet is ingesteld.

Het verzoek was onaanvaardbaar. Veel voorkomende oorzaken:

• Ontbrekende parameter: Een vereiste 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 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 maken van een verfijn 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 emissiekaart is ook inbegrepen wanneer ai_model meshy-6 is, behalve bij texture_resolution: 8k (geen emissiekaart wordt geproduceerd). meshy-7 (en latest) produceert geen emissiekaart.

Resolutie van basiskleurtexturen. Een van 2k (2048×2048), 4k (4096×4096) of 8k (8192×8192). Hogere resoluties leggen meer oppervlakdetail vast. Alleen van toepassing op de refine mode.

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

Geef een aanvullende tekstprompt om het textureerproces te leiden. Maximaal 600 tekens.

Bied een 2D-afbeelding aan om het textureerproces te leiden. We ondersteunen momenteel .jpg, .jpeg, en .png formats.

Er zijn twee manieren om de afbeelding te verstrekken:

• Openbaar 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 model dat voor verfijning moet worden gebruikt. Beschikbare waarden: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Wanneer ingesteld op true, wordt de invoerinhoud automatisch gescreend op potentieel schadelijke inhoud. Als schadelijke inhoud wordt gedetecteerd, zal de taak niet doorgaan naar generatie.

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

Verwijdert highlights en schaduwen uit de basiskleurtextuur, wat resulteert in een schoner resultaat dat beter werkt onder aangepaste verlichtingsopstellingen.

Specificeert welke 3D-bestandsformaten in de uitvoer moeten worden opgenomen. Alleen de aangevraagde formaten worden gegenereerd en geretourneerd, wat de taakvoltooiingstijd kan bekorten. Wanneer weggelaten, zijn alle ondersteunde formaten inbegrepen.

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

Wanneer ingesteld op true, renderert de taak ook een transparante achtergrond (RGBA) versie van de preview en retourneert deze als alpha_thumbnail_url in de GET-reactie. Het bestaande thumbnail_url veld 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 te schalen. De oorsprong zal standaard naar bottom gaan, tenzij origin_at expliciet is ingesteld.

Het verzoek was onaanvaardbaar. Veel voorkomende oorzaken:

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

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De preview taak gespecificeerd door preview_task_id is niet gevonden.

Je hebt je rate limit overschreden.

Unieke identificatie voor de Tekst naar 3D taak om op te halen.

De ID van de Tekst naar 3D taak om te verwijderen.

Paginanummer voor paginering.

Paginagrootte limiet. Maximaal toegestaan is 50 items.

Veld om te sorteren.

Beschikbare waarden:

• +created_at: Sorteren op creatietijd in oplopende volgorde.
• -created_at: Sorteren op creatietijd in aflopende volgorde.

Unieke identificatie voor de Tekst naar 3D taak om te streamen.

Unieke identificatie voor de taak. Terwijl we een k-sorteerbare UUID gebruiken voor taak-id's als implementatiedetail, moet je geen aannames maken over het format van de id.

Type van de Tekst naar 3D taak. Mogelijke waarden zijn text-to-3d-preview voor preview stadium taken en text-to-3d-refine voor verfijn stadium taken.

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

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

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

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

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

Aanvullende tekstprompt verstrekt om het texturering proces tijdens het verfijn stadium te leiden.

Echoët de ultra_mode waarde die de preview taak werd gemaakt met. Alleen aanwezig voor meshy-7 (of latest) preview taken die expliciet ultra_mode instelden; anders weggelaten.

Downloadbare URL naar de textureafbeelding die werd gebruikt om het texturering proces te leiden.

Downloadbare URL naar de thumbnail afbeelding van het modelbestand.

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

Downloadbare URL naar de preview video. Zal in een toekomstige release worden verwijderd.

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

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

Tijdstempel van wanneer de taak werd gecreëerd, in milliseconden.

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

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

Een lijst van textuur URL-objecten die zijn gegenereerd uit de taak. 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 task_error objectreferentie.

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 falen).