Tekst naar 3D API

De stap van de workflow in twee stappen. Stuur preview om een preview-taak aan te maken.

Tekst die het te genereren object beschrijft, tot 800 tekens. Langere tekst geeft 400 terug.

Het type 3D-mesh dat gegenereerd moet worden.

Beschikbare waarden:

• standard: een 3D-mesh met hoog detailniveau
• smart-topology: een Smart Topology-mesh. Kies het model met ai_model (meshy-t2 of meshy-t2.5).

Bij smart-topology negeert Meshy should_remesh en decimation_mode, en accepteert het alleen topology: triangle.

Het AI-model dat het 3D-model genereert. De beschikbare waarden zijn afhankelijk van model_type.

Standaardmodellen (model_type: standard):

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

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

• meshy-t2: schonere topology, van nature gescheiden onderdelen, triangle-output, en een polygoonaantal dat je instelt met target_polycount
• meshy-t2.5 (standaard): scherper detail voor game-assets, triangle-output, en een polygoonaantal dat je instelt met target_polycount

Zie Modellen voor welk model bij jouw project past, zoals een gamekarakter of een 3D-print.

De geometrie-generatiepas. Geldt alleen voor preview-taken. Een refine met deze parameter geeft 400 terug.

Beschikbare waarden:

• standard
• 2k: voert de Ultra-pas uit op 2048³
• 4k: voert de Ultra-pas uit op 4096³, voor fijner oppervlaktedetail

2k vereist meshy-7.1, latest, of het verouderde meshy-7. 4k vereist meshy-7.1 of latest. Andere modellen geven 400 terug.

Stuur in plaats daarvan geometry_resolution. ultra_mode: true is hetzelfde als geometry_resolution: "2k".

Of het model na generatie opnieuw gemesht moet worden. Stuur voor het 3D-model van de hoogste kwaliteit false.

Het aantal polygonen om naar te streven. Het resultaat kan afwijken van het doel, afhankelijk van de geometrie. Dit geldt in twee afzonderlijke gevallen:

• Remesh: met should_remesh: true op een standard-model. Meshy remesht (decimeert) de mesh tot ongeveer dit aantal. Als je decimation_mode instelt, gebruikt Meshy dat en negeert het target_polycount.
• Smart Topology: met model_type: smart-topology en ai_model meshy-t2 of meshy-t2.5. Meshy genereert het model direct met dit polygoonaantal. Er wordt geen remesh uitgevoerd, en je hebt should_remesh niet nodig.

De volgende tabel toont het bereik en de standaardwaarde voor elk geval:

Een waarde buiten het bereik geeft 400 terug.

Gebruik voor een low-poly game-asset een Smart Topology-model in plaats van een standaardmodel te remeshen. Zie Modellen.

Laat deze weg. Deze parameter heeft geen effect op de output.

Beschikbare waarden:

• off: schakelt symmetrie uit
• auto: past symmetrie toe op basis van de invoergeometrie
• on: dwingt symmetrie af tijdens generatie

De pose van het gegenereerde model.

Beschikbare waarden:

• a-pose: een A-pose
• t-pose: een T-pose
• "" (lege string): geen specifieke pose

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

Laat deze weg. Meshy negeert deze.

Of prompt vóór generatie gescreend moet worden op schadelijke inhoud. Als Meshy schadelijke inhoud detecteert, geeft het verzoek 400 terug en maakt Meshy geen taak aan.

De bestandsformaten die gegenereerd moeten worden. Meshy genereert en retourneert alleen deze formaten, wat de taak kan verkorten. Als je dit weglaat, genereert Meshy elk formaat behalve 3mf, dat het alleen genereert wanneer je dit specifiek aanvraagt.

Beschikbare waarden:

• glb
• obj
• fbx
• stl
• usdz
• 3mf

Of ook een preview met een transparante achtergrond (RGBA) gerenderd moet worden, geretourneerd in alpha_thumbnail_url wanneer je de taak ophaalt. thumbnail_url verandert niet.

Of de werkelijke hoogte van het object met AI-visie geschat en het model daarop geschaald moet worden. Meshy plaatst de oorsprong onderaan, tenzij je origin_at instelt.

Het verzoek kan niet worden uitgevoerd. Het foutbericht geeft aan welk probleem is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: Een vereiste parameter, zoals prompt of mode, ontbreekt.
• Prompt te lang: prompt overschrijdt de tekenlimiet.
• Niet-ondersteund model voor Ultra: geometry_resolution is 2k of 4k, met een ai_model die dit niet kan uitvoeren.

Corrigeer het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft niet genoeg credits voor deze taak, of het account heeft een credietlimiet bereikt. Controleer je credit-saldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade je abonnement in je abonnementsinstellingen en probeer het opnieuw.

Contentmoderatie heeft de prompt of een invoerafbeelding geblokkeerd. Wijzig de invoer en probeer het opnieuw.

Je hebt je rate limit overschreden. Wacht en probeer het opnieuw. Zie Rate limits.

De stap van de workflow in twee stappen. Stuur refine om een refine-taak aan te maken.

De ID van de preview-taak die van textuur moet worden voorzien. De preview-taak moet de status SUCCEEDED hebben.

Of ook PBR-maps (metallic, roughness en normal) moeten worden gegenereerd naast de basiskleur.

Met ai_model meshy-6 genereert Meshy ook een emissiemap, behalve bij texture_resolution: 8k. meshy-6-lite, meshy-7, meshy-7.1 en latest genereren geen emissiemap. Dat geldt ook voor een refine van een meshy-t2- of meshy-t2.5-preview waarbij ai_model niet is ingesteld. Met ai_model: meshy-n1 geeft true een 400.

De resolutie van de basiskleurtextuur. Geldt alleen voor refine-taken. Een preview met deze parameter geeft 400.

Beschikbare waarden:

• 2k: 2048×2048
• 4k: 4096×4096
• 8k: 8192×8192

Hogere resoluties leggen meer oppervlaktedetail vast. 4k en 8k vereisen ai_model meshy-6, meshy-7.1 of latest. Met meshy-n1 geven ze 400. Bij 8k genereert Meshy geen emissiemap.

Stuur in plaats daarvan texture_resolution. hd_texture: true is hetzelfde als texture_resolution: "4k". Als u beide stuurt, gebruikt Meshy texture_resolution.

Tekst die de textuurvorming stuurt, tot 800 tekens. Langere tekst geeft 400. Stuur texture_prompt of texture_image_url, niet beide. Als u beide stuurt, gebruikt Meshy texture_prompt. Met ai_model: meshy-n1 geeft het sturen hiervan 400.

Een 2D-afbeelding die de textuurvorming stuurt, als openbare URL of als base64-gecodeerde Data URI, zoals data:image/jpeg;base64,<uw base64-gecodeerde afbeeldingsgegevens>.

De afbeelding moet een .jpg-, .jpeg-, .png- of .webp-bestand zijn van maximaal 20 MB, minimaal 32 pixels aan elke zijde en maximaal 178.956.970 pixels (breedte × hoogte).

Met ai_model: meshy-n1 gebruikt Meshy deze afbeelding als vooraanzicht voor de textuurvorming.

Het AI-model dat de mesh van textuur voorziet.

Beschikbare waarden:

• meshy-6-lite
• meshy-6
• meshy-7.1
• latest: Meshy 7.1
• meshy-n1: een 2K-basiskleurtextuur, uitsluitend op basis van een referentieafbeelding. Geen tekstprompt, geen PBR-maps, geen 4K of 8K.
• meshy-7 (verouderd): stuur in plaats daarvan meshy-7.1

Laat deze parameter weg om het model van de preview-taak te gebruiken, zodat de preview en de bijbehorende refine van begin tot eind met hetzelfde model draaien. Stuur een waarde om dit te overschrijven. Een expliciete latest wordt op dezelfde manier herleid als bij de preview-taak, zodat een latest-preview en de bijbehorende latest-refine altijd hetzelfde textuurmodel gebruiken.

Met meshy-n1 voorziet Meshy van textuur op basis van texture_image_url. Zonder deze parameter gebruikt Meshy de referentieafbeelding die is opgeslagen bij een meshy-7.1- of latest-preview. Elke andere preview geeft 400, tenzij u texture_image_url meestuurt. De preview mag maximaal 7.999.999 driehoeken bevatten. Een preview die is geremesht naar quads geeft 400.

Of texture_prompt en texture_image_url vóór het genereren moeten worden gescreend op schadelijke inhoud. Als Meshy schadelijke inhoud detecteert, geeft het verzoek 400 en maakt Meshy geen taak aan.

Of hooglichten en schaduwen uit de basiskleurtextuur moeten worden verwijderd. Het resultaat is zo schoner en werkt beter bij aangepaste belichting.

Heeft alleen effect wanneer ai_model meshy-6 is. meshy-7.1 en latest accepteren deze parameter maar negeren hem, net als een refine van een meshy-t2- of meshy-t2.5-preview waarbij ai_model niet is ingesteld. Het sturen hiervan met meshy-6-lite geeft 400. Met meshy-n1 geeft true een 400.

De bestandsformaten die moeten worden gegenereerd. Meshy genereert en retourneert alleen deze formaten, wat de taak kan verkorten. Als u dit weglaat, genereert Meshy elk formaat behalve 3mf, dat alleen wordt gegenereerd wanneer u erom vraagt.

Beschikbare waarden:

• glb
• obj
• fbx
• stl
• usdz
• 3mf

Of ook een preview met transparante achtergrond (RGBA) moet worden gerenderd, geretourneerd in alpha_thumbnail_url wanneer u de taak opvraagt. thumbnail_url verandert niet.

Of de werkelijke hoogte van het object moet worden geschat met AI-visie en het model daarop in formaat moet worden aangepast. Meshy plaatst de oorsprong onderaan, tenzij u origin_at instelt.

Het verzoek kan niet worden uitgevoerd. Het foutbericht geeft aan welk probleem is gevonden. Bijvoorbeeld:

• Ongeldige taak-ID: preview_task_id is ongeldig of komt niet overeen met een van uw preview-taken.
• Taak nog niet gereed: De preview-taak is nog niet geslaagd.
• Modelmismatch: Het AI-model van de preview-taak werkt niet met het gevraagde refine-model.
• Niet-ondersteund model voor remove_lighting: remove_lighting werd gestuurd met ai_model: "meshy-6-lite".
• Geen referentieafbeelding voor Meshy N1: ai_model: meshy-n1 werd gestuurd zonder texture_image_url, en de preview heeft geen referentieafbeelding die Meshy N1 kan gebruiken. Stuur texture_image_url.
• Quad-preview voor Meshy N1: ai_model: meshy-n1 werd gestuurd voor een preview die naar quads is geremesht. Verfijn deze met een ander ai_model.
• Te veel driehoeken voor Meshy N1: Met ai_model: meshy-n1 heeft de preview meer dan 7.999.999 driehoeken. Verfijn deze met een ander ai_model.
• Niet-ondersteunde optie voor Meshy N1: ai_model: meshy-n1 werd gestuurd met een van deze opties:
  • texture_prompt
  • enable_pbr: true
  • texture_resolution van 4k of 8k
  • hd_texture: true zonder texture_resolution
  • remove_lighting: true

Herstel het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de header Authorization.

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft onvoldoende credits voor deze taak, of het account heeft een credietlimiet bereikt. Controleer uw creditsaldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade uw abonnement via uw abonnementsinstellingen en probeer het opnieuw.

Contentmoderatie heeft de prompt of een invoerafbeelding geblokkeerd. Wijzig de invoer en probeer het opnieuw.

U heeft uw rate limit overschreden. Wacht en probeer het opnieuw. Zie Rate limits.

De taak-ID uit de aanmaakrespons.

De ID van de te verwijderen taak.

Het paginanummer dat moet worden geretourneerd, tot 255. Een hogere waarde levert 400 op.

Het aantal taken per pagina, tot 100.

De sorteervolgorde.

Beschikbare waarden:

• +created_at: oudste eerst
• -created_at: nieuwste eerst

De taak-ID uit de respons van het aanmaken.

De taak-ID. Behandel dit als een ondoorzichtige string en vertrouw niet op het format ervan.

Het taaktype, text-to-3d-preview voor een preview-taak of text-to-3d-refine voor een refine-taak.

Download-URL's voor het gegenereerde 3D-model, één per bestandsformaat. Een formaat dat de taak niet heeft gegenereerd, heeft geen sleutel, in plaats van een lege string.

De prompt die je hebt verstuurd om de taak aan te maken, ongewijzigd.

De tekstprompt die je hebt verstuurd om de texturing in de refine-fase te sturen.

Gebruik in plaats daarvan geometry_resolution.

De Ultra-tier waarmee de preview-taak is uitgevoerd, 2k of 4k. Dit veld ontbreekt voor standard.

Download-URL voor de afbeelding die je hebt verstuurd om de texturing te sturen.

Download-URL voor een thumbnailafbeelding van het 3D-model.

Download-URL voor een versie van thumbnail_url met een transparante achtergrond (RGBA). Alleen aanwezig wanneer je de taak hebt aangemaakt met alpha_thumbnail: true en Meshy de transparante preview heeft gerenderd.

Hoeveel van de taak is voltooid, als percentage. Dit is 0 totdat de taak start en 100 wanneer deze slaagt.

Tijdstip waarop de taak is gestart, in Unix-milliseconden. Dit is 0 totdat de taak start.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop de taak is beëindigd, in Unix-milliseconden. Dit is 0 totdat de taak eindigt.

De taakstatus, een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, of CANCELED.

Download-URL's voor de gegenereerde textuurkaarten, als een array van objecten. Deze bevat gewoonlijk één object. Elk object heeft de volgende velden:

Het aantal taken dat vóór deze taak in de wachtrij staat. De waarde is alleen zinvol zolang de taak PENDING is.

De foutdetails wanneer de taak mislukt. Dit is null tenzij de status FAILED is. Zie Fouten.

Het aantal credits dat de taak heeft gebruikt. Aanwezig wanneer de status PENDING, IN_PROGRESS, of SUCCEEDED is. Dit is 0 voor een FAILED-taak, omdat Meshy de credits terugbetaalt wanneer een taak mislukt.