Afbeelding naar 3D API

Verplicht, tenzij u image_url meestuurt. De ID van een Tekst naar afbeelding- of Afbeelding naar afbeelding-taak waarvan u de afbeelding als invoer wilt gebruiken. De taak moet er een zijn die u met de API hebt aangemaakt, de status SUCCEEDED hebben en precies één afbeelding hebben opgeleverd.

Verplicht, tenzij u input_task_id meestuurt. De afbeelding die naar een 3D-model moet worden omgezet, als een openbare URL of een base64-gecodeerde data-URI, zoals data:image/jpeg;base64,<uw base64-gecodeerde afbeeldingsgegevens>. Als u beide meestuurt, gebruikt Meshy input_task_id.

De afbeelding moet een JPG-, JPEG-, PNG- of WebP-bestand van maximaal 20 MB zijn, minstens 32 pixels aan elke zijde, en maximaal 178.956.970 pixels (breedte × hoogte).

Het soort 3D-mesh dat gegenereerd moet worden.

Beschikbare waarden:

• standard: een mesh met veel detail
• smart-topology: een mesh van een Smart Topology-model, dat u kiest met ai_model (meshy-t2 of meshy-t2.5)

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

Het AI-model dat het 3D-model genereert. De beschikbare waarden hangen af van model_type.

Standaardmodellen (model_type: standard):

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

Smart Topology-modellen (model_type: smart-topology) produceren driehoeken, met een aantal vlakken dat u instelt met target_polycount:

• meshy-t2: schonere topology en van nature gescheiden onderdelen
• meshy-t2.5 (standaard): scherper detail voor game-assets

De pass voor het genereren van de geometrie.

Beschikbare waarden:

• standard
• 2k: voert de Ultra-pass uit op 2048³
• 4k: voert de Ultra-pass uit op 4096³, voor het meeste oppervlaktedetail

2k vereist meshy-7.1, latest, of de verouderde meshy-7. 4k vereist meshy-7.1 of latest.

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

Of texturen gegenereerd moeten worden. true levert een getextureerd model op, en false slaat texturering over en levert een niet-getextureerde mesh op.

Of de remesh-fase moet worden uitgevoerd. Voor het best mogelijke 3D-model stelt u dit in op false.

Het aantal vlakken om naar te streven. Het resultaat kan afwijken van het doel, afhankelijk van de geometrie van het model.

Dit geldt in twee afzonderlijke gevallen:

• Remesh: Wanneer should_remesh op true staat bij een standard-model, decimeert Meshy de mesh naar ongeveer dit aantal. Als u decimation_mode instelt, gebruikt Meshy dat en negeert het target_polycount.
• Smart Topology: Wanneer model_type smart-topology is en ai_model meshy-t2 of meshy-t2.5 is, genereert Meshy het model met dit aantal vlakken. Er vindt geen remesh plaats, en u heeft should_remesh niet nodig.

Het bereik en de standaardwaarde hangen af van het geval:

Een waarde buiten het bereik geeft 400 terug.

Laat dit weg, omdat het geen invloed heeft op de uitvoer. De waarden ervan bepaalden de symmetrie tijdens het genereren:

• off: geen symmetrie
• auto: symmetrie gekozen op basis van de invoergeometrie
• on: afgedwongen symmetrie

De pose voor het gegenereerde model.

Beschikbare waarden:

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

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

Gebruik in plaats daarvan ai_model. Het heeft geen invloed op de uitvoer, omdat de modelgeneratie die hiermee geselecteerd werd niet meer in gebruik is.

Geaccepteerde waarden zijn organic en hard. Elke andere waarde geeft 400 terug.

Of de invoerafbeelding geoptimaliseerd moet worden vóór het genereren. false behoudt het exacte uiterlijk van de invoerafbeelding, zonder stijlverwerking.

Dit werkt alleen met meshy-6, meshy-7.1 of latest. Met meshy-6-lite of model_type: smart-topology geeft het 400 terug.

Of hooglichten en schaduwen uit de basiskleurtextuur verwijderd moeten worden. Het resultaat is schoner en werkt beter onder uw eigen belichting.

Dit heeft alleen effect met het Meshy 6-textuurmodel, en een textuurmodel dat het niet ondersteunt geeft 400 terug voor true. Met model_type: smart-topology, of met ai_model: meshy-6-lite en het bijbehorende standaard textuurmodel, geeft het meesturen hiervan 400 terug.

Of deze invoer gescreend moet worden op schadelijke inhoud vóór het genereren:

• image_url
• texture_image_url
• texture_prompt

Als Meshy schadelijke inhoud detecteert, geeft het verzoek 400 terug en maakt Meshy geen taak aan.

De bestandsformaten om te genereren. Meshy genereert en retourneert alleen de formaten die u opgeeft, wat de taak kan verkorten. Als u dit weglaat, genereert Meshy elk formaat behalve 3mf, dat u alleen krijgt wanneer u het opgeeft.

Beschikbare waarden:

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

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

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

Of er ook voorbeelden van voor-, rechter-, achter- en linkerkant gerenderd moeten worden, geretourneerd in thumbnail_urls wanneer u de taak ophaalt. thumbnail_url verandert niet en toont nog steeds het vooraanzicht. Dit voegt ongeveer 5 seconden toe aan de taak.

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

• Ontbrekende parameter: Noch image_url noch input_task_id is meegestuurd.
• Ongeldige invoertaak: input_task_id is geen SUCCEEDED Tekst naar afbeelding- of Afbeelding naar afbeelding-taak die precies één afbeelding heeft opgeleverd.
• Ongeldig afbeeldingsformaat: De afbeelding bij image_url is geen JPG-, JPEG-, PNG- of WebP-bestand.
• Onbereikbare URL: Meshy kan de afbeelding bij image_url niet downloaden, omdat de URL 404 teruggeeft of een time-out geeft.
• Afbeelding te groot: De afbeelding bij image_url of texture_image_url is groter dan 20 MB.
• Ongeldige afbeeldingsgrootte: De afbeelding bij image_url of texture_image_url heeft een zijde korter dan 32 pixels, of meer dan 178.956.970 pixels (breedte × hoogte).
• Ongeldige data-URI: De base64-string is onjuist opgebouwd.
• Ongeldige combinatie van parameters: enable_pbr is true, en should_texture is false.
• Niet-ondersteund model voor Ultra: geometry_resolution is 2k of 4k, met een ai_model die dit niet kan uitvoeren.
• Niet-ondersteund model voor afbeeldingsopties: één van de volgende:
  • image_enhancement is meegestuurd met ai_model: "meshy-6-lite" of model_type: "smart-topology".
  • remove_lighting is meegestuurd met model_type: "smart-topology", of met ai_model: "meshy-6-lite" en het bijbehorende standaard textuurmodel.
• Ongeldig textuurmodel: texture_model is geen van de beschikbare waarden.
• Textuurmodel niet beschikbaar: texture_model is meshy-6 met een ai_model anders dan meshy-6. Stuur meshy-7, meshy-n1 of meshy-6-lite mee, of laat het weg.
• Niet-ondersteunde optie voor het textuurmodel: Het verzoek vraagt het textuurmodel om een optie die het niet ondersteunt, zoals enable_pbr: true met meshy-n1 of een 4k-textuur met meshy-6-lite. Zie Modellen.

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 onvoldoende credits voor deze taak, of het account heeft een creditlimiet bereikt. Controleer uw creditsaldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade uw abonnement in uw abonnementsinstellingen en probeer het opnieuw.

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

input_task_id komt met geen van uw taken overeen. Controleer de taak-ID en stuur het verzoek opnieuw.

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

De taak-ID uit het antwoord van het aanmaken.

De ID van de te verwijderen taak.

Het paginanummer dat geretourneerd wordt, 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 create-respons.

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

Het taaktype, altijd image-to-3d.

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

Downloadlink voor een voorbeeldafbeelding van het 3D-model. Wanneer thumbnail_urls aanwezig is, is dit dezelfde afbeelding als thumbnail_urls.front. Meshy behoudt dit veld voor achterwaartse compatibiliteit.

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

Downloadlinks voor previews van het 3D-model vanuit vier zijden. Elke waarde is een ondertekende URL naar een 512×512 PNG, gerenderd met dezelfde materialen en belichting als thumbnail_url. Gebruik ze om het model vanuit verschillende hoeken te bekijken, bijvoorbeeld in een batchpijplijn, zonder de GLB te downloaden.

Alleen aanwezig wanneer je de taak hebt aangemaakt met multi_view_thumbnails: true en de taak SUCCEEDED heeft bereikt. Taken die zijn aangemaakt zonder multi_view_thumbnails: true bevatten dit veld niet.

De tekstprompt die de textuur heeft gestuurd.

Downloadlink voor de afbeelding die de textuur heeft gestuurd.

Lees in plaats daarvan geometry_resolution.

De Ultra-laag waarin de taak is uitgevoerd, 2k of 4k. Een standard-taak bevat dit veld niet.

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 het resultaat van de taak verloopt, in Unix-milliseconden.

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

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

De texturen die de taak heeft gegenereerd, als een array van objecten. Deze bevat meestal één object, met de volgende velden:

Het aantal taken dat vóór deze taak in de wachtrij staat. De waarde is alleen betekenisvol 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.