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 mesh-generatie op.

Beschikbare waarden:

• standard: Reguliere hoogwaardige mesh-generatie.
• smart-topology: Kies het Smart Topology-model met ai_model (meshy-t2).
• lowpoly (verouderd): Genereert een low-poly mesh die is geoptimaliseerd voor schonere polygonen. We raden aan 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-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 (standaard): het Smart Topology-model — schonere topology, van nature gescheiden onderdelen, driehoeksuitvoer, en een aantal vlakken dat je kunt instellen met target_polycount.

Geometriegeneratiepas. 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 komt overeen met geometry_resolution: "2k".

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

Doelaantal polygonen (vlakken) in de uitvoer. 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 voorrang en wordt target_polycount genegeerd.
• Smart Topology — met model_type: smart-topology en ai_model: meshy-t2. Het model wordt direct met dit aantal vlakken gegenereerd; 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 uitvoer.

Het veld symmetry_mode bepaalt het symmetriegedrag tijdens het genereren van het model.

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

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 tekenreeks): 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. Aanvragen 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.

Geeft aan welke 3D-bestandsformaten in de uitvoer moeten worden opgenomen. Alleen de aangevraagde formaten worden gegenereerd en geretourneerd, wat de doorlooptijd 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 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 van formaat te wijzigen. De oorsprong staat standaard op 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.
• 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 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-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 meegeleverd wanneer ai_model is ingesteld op meshy-6, behalve bij texture_resolution: 8k (dan wordt geen emission map geproduceerd). meshy-6-lite, meshy-7.1 en latest produceren 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 — gelijk aan texture_resolution: "4k". Wanneer 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 wordt voor het refinen.

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 wordt gebruikt, zodat een preview en de bijbehorende refine end-to-end op hetzelfde model blijven. Geef een expliciete waarde op om deze overname te overschrijven.

Wanneer ingesteld op true, wordt de invoerinhoud automatisch gescreend op potentieel 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 highlights 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

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 het GET-antwoord. 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 aan te passen. De oorsprong staat standaard op bottom, tenzij origin_at expliciet is ingesteld.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

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

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De preview-taak die is opgegeven via preview_task_id is niet gevonden.

U heeft uw rate limit overschreden.

Unieke identifier van de op te halen Text to 3D-taak.

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

Paginanummer voor paginering.

Limiet voor paginagrootte. 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-sorteerbare UUID gebruiken voor taak-id's als implementatiedetail, moet je geen aannames doen over het formaat 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 terug te geven.

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; lees in plaats daarvan geometry_resolution.

De Ultra-tier waarmee de preview-taak is uitgevoerd (2k of 4k); wordt 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 texture URL-objecten die door de taak zijn gegenereerd. Normaal gesproken bevat dit slechts één texture URL-object. Elke texture 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 terugbetaald bij mislukking).