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 hoge detaillering.
• 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 om in plaats daarvan 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, driehoeksoutput, en een polygoonaantal dat je kunt instellen met target_polycount.

Schakelt Ultra-generatie in voor geometrie van hogere kwaliteit met 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 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. Het model wordt direct gegenereerd met dit polygoonaantal; er wordt geen remesh uitgevoerd en should_remesh is niet vereist. Bereik 100 tot 15.000, standaard 4.000.

Verouderd. Deze parameter heeft geen invloed 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.

Geef de pose-mode voor het gegenereerde model op.

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 verder naar generatie.

De tekst uit prompt wordt gescreend.

Specificeert welke 3D-bestandsindelingen in de output moeten worden opgenomen. Alleen de gevraagde indelingen worden gegenereerd en geretourneerd, wat de doorlooptijd van de taak kan verkorten. Wanneer weggelaten, worden alle ondersteunde indelingen 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 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 aanmaken van een refine-taak.

De bijbehorende preview-task-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 (dan wordt geen emission map geproduceerd). meshy-7 (en latest) produceert geen emission map.

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

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

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 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 bij aangepaste belichtingsopstellingen.

Bepaalt welke 3D-bestandsformaten in de uitvoer worden opgenomen. Alleen de gevraagde 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 bovendien een versie van de preview met transparante achtergrond (RGBA) en retourneert deze als alpha_thumbnail_url in de GET-response. 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 te herschalen. De oorsprong wordt standaard bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ongeldige task-ID: de preview_task_id is ongeldig of bestaat niet.
• Taak nog niet gereed: de preview-taak is nog niet geslaagd.
• Model komt niet overeen: het AI-model van de preview-taak is niet compatibel met het gevraagde refine-model.

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De preview-taak opgegeven via preview_task_id is niet gevonden.

Je hebt je rate limit overschreden.

Unieke identificatie voor de Tekst naar 3D-taak die je wilt ophalen.

De ID van de Tekst naar 3D-taak die moet worden verwijderd.

Paginanummer voor paginering.

Limiet van de paginagrootte. 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 identifier voor de taak. Hoewel we als implementatiedetail een k-sorteerbare UUID gebruiken voor taak-id's, 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 tekenreeks terug te geven.

Dit is de ongewijzigde prompt die is gebruikt om de taak 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 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.

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

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

Downloadbare URL naar de previewvideo. Zal in een toekomstige release worden 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 het moment waarop de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

Tijdstempel van het moment waarop de taak is gemaakt, in milliseconden.

Tijdstempel van het moment waarop 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 bij mislukking terugbetaald).