Tekst naar 3D API

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

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

Geef het type 3D-meshgeneratie op.

Beschikbare waarden:

• standard: Reguliere 3D-meshgeneratie met veel detail.
• lowpoly: Genereert een low-poly mesh die is geoptimaliseerd voor schonere polygonen.

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

Bepaalt of de remesh-fase wordt ingeschakeld. Wanneer ingesteld op false, retourneert de API direct de driehoekige mesh met de hoogste precisie.

Verouderd (deprecated). Deze parameter heeft geen invloed meer op de uitvoer.

Het veld symmetry_mode bepaalt het symmetriegedrag tijdens het modelgeneratieproces.

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 de generatie.

Geef de pose_mode voor het gegenereerde model op.

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 in plaats daarvan pose_mode. Of het model in een A/T-pose moet worden gegenereerd.

Niet ondersteund door Meshy-6. Verzoeken die Meshy-6 gebruiken, 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 generatie.

De tekst uit prompt wordt gescreend.

Geeft aan welke 3D-bestandsindelingen in de uitvoer moeten worden opgenomen. Alleen de aangevraagde indelingen worden gegenereerd en geretourneerd, wat de voltooiingstijd van de taak kan verkorten. Wanneer dit wordt 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 formaat van het model dienovereenkomstig te wijzigen. De oorsprong wordt standaard bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was niet acceptabel. 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 uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

U hebt uw rate limit overschreden.

Dit veld moet worden ingesteld op "refine" bij het maken van een verfijningstaak.

De bijbehorende previewtaak-id.

De status van de opgegeven previewtaak moet SUCCEEDED zijn.

Genereer PBR-maps (metallic, roughness, normal) naast de basiskleur. Een emissiemap wordt ook opgenomen wanneer ai_model meshy-6 of latest is.

Genereer de basiskleurtextuur met 4K-resolutie (4096×4096) voor meer detail.

Geef een aanvullende tekstprompt op om het textureringsproces te sturen. Maximaal 600 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:

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

Wanneer 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 wordt gescreend.

Verwijdert highlights en schaduwen uit de basiskleurtextuur, waardoor een schoner resultaat ontstaat 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. Wanneer dit wordt weggelaten, worden alle ondersteunde formaten opgenomen.

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

Wanneer ingesteld op true, rendert de taak daarnaast 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 van formaat te wijzigen. De oorsprong wordt standaard ingesteld op bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was niet acceptabel. Veelvoorkomende oorzaken:

• Ongeldige taak-ID: De preview_task_id is ongeldig of bestaat niet.
• Taak niet gereed: De previewtaak is nog niet geslaagd.
• Model komt niet overeen: Het AI-model van de previewtaak is incompatibel met het aangevraagde verfijningsmodel.

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De previewtaak die is opgegeven door preview_task_id is niet gevonden.

Je hebt je 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.

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

Unieke identifier voor de taak. Hoewel we een k-sorteerbare UUID voor taak-id's gebruiken als implementatiedetail, moet je geen aannames doen over de indeling van de id.

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

Downloadbare URL naar het getextureerde 3D-modelbestand dat door Meshy is gegenereerd. De eigenschap voor een indeling wordt weggelaten als de indeling niet wordt 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 impact op gegenereerde modellen.

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

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

Aanvullende tekstprompt die wordt verstrekt om het textureringsproces tijdens de verfijningsfase te sturen.

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 met transparante achtergrond (RGBA) van thumbnail_url. 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 verwijderd in een toekomstige release.

progress 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 uit de taak worden 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 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 mislukking).