Text till 3D API

Detta fält ska sättas till "preview" när en preview-uppgift skapas.

Beskriv vilken typ av objekt 3D-modellen är. Max 800 tecken.

Ange typen av 3D-nätgenerering.

Tillgängliga värden:

• standard: Vanlig högdetaljerad 3D-nätgenerering.
• smart-topology: Välj Smart Topology-modellen med ai_model (meshy-t2).
• lowpoly (föråldrad): Genererar low-poly-nät optimerat för renare polygoner. Vi rekommenderar att du använder smart-topology istället.

ID för modellen som ska användas. Tillgängliga värden beror på model_type.

Standardgenerering (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (föråldrad): använd meshy-7.1 istället.

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

• meshy-t2 (standard): Smart Topology-modellen — renare topology, naturligt separerade delar, triangelutdata, och ett polygonantal du kan ställa in med target_polycount.

Geometrigenereringspass. 2k kör Ultra-passet vid 2048³; 4k kör det vid 4096³ för det finaste ytdetaljerna.

Tillgängliga värden: standard, 2k, 4k

Använd geometry_resolution istället. ultra_mode: true motsvarar geometry_resolution: "2k".

Styr om remesh-fasen ska aktiveras. För modellen med högst kvalitet rekommenderar vi att sätta should_remesh till false.

Målantal polygoner (ytor) i utdata. Det faktiska antalet kan avvika från målet beroende på geometrin.

target_polycount har effekt i två oberoende fall:

• Remesh — med should_remesh: true på en standard-modell. Nätet remesh:as (decimeras) till ungefär detta antal. Intervall 100 till 300 000, standard 30 000. Om decimation_mode är angivet har det prioritet och target_polycount ignoreras.
• Smart Topology — med model_type: smart-topology och ai_model: meshy-t2. Modellen genereras direkt med detta antal ytor; ingen remesh körs och should_remesh behövs inte. Intervall 100 till 15 000, standard 4 000.

Föråldrad. Denna parameter påverkar inte längre utdata.

Fältet symmetry_mode styr symmetribeteendet under modellgenereringsprocessen.

De giltiga värdena är:

• off: Inaktiverar symmetri.
• auto: Bestämmer och tillämpar automatiskt symmetri baserat på ingående geometri.
• on: Tvingar fram symmetri under generering.

Ange pose_mode för den genererade modellen.

Tillgängliga värden:

• a-pose: Generera modellen i en A-pose.
• t-pose: Generera modellen i en T-pose.
• "" (tom sträng): Ingen specifik pose tillämpas.

Använd pose_mode istället. Om modellen ska genereras i en A/T-pose.

Stöds inte av Meshy-6. Förfrågningar som använder Meshy-6 kommer att ignorera art_style, och vissa kombinationer kan orsaka fel. Tillgängliga värden: realistic, sculpture.

När detta sätts till true kommer innehållet automatiskt att granskas för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks kommer uppgiften inte att fortsätta till generering.

Texten från prompt kommer att granskas.

Anger vilka 3D-filformat som ska ingå i utdata. Endast de begärda formaten genereras och returneras, vilket kan minska tiden för att slutföra uppgiften. När detta utelämnas inkluderas alla format som stöds.

Tillgängliga värden: glb, obj, fbx, stl, usdz, 3mf

När detta sätts till true renderar uppgiften dessutom en version av förhandsvisningen med transparent bakgrund (RGBA) och returnerar den som alpha_thumbnail_url i GET-svaret. Det befintliga fältet thumbnail_url förblir oförändrat.

När detta sätts till true använder tjänsten AI-syn för att automatiskt uppskatta objektets verkliga höjd och ändra storlek på modellen därefter. Origo kommer som standard att sättas till bottom om inte origin_at uttryckligen anges.

Förfrågan kunde inte accepteras. Vanliga orsaker:

• Saknad parameter: En obligatorisk parameter (t.ex. prompt, mode) saknas.
• Ogiltig parameter: art_style är inte ett av de tillåtna värdena.
• Prompt för lång: prompt överskrider teckengränsen.
• Modell stöds inte för low poly: ai_model: "meshy-6-lite" stöder inte model_type: "lowpoly".
• Modell stöds inte för Ultra: geometry_resolution kräver meshy-7.1 eller latest.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna uppgift.

Du har överskridit din hastighetsgräns.

Detta fält ska sättas till "refine" när en refine-task skapas.

Motsvarande preview-task-id.

Statusen för den angivna preview-tasken måste vara SUCCEEDED.

Generera PBR-mappar (metallic, roughness, normal) utöver basfärgen. En emissionskarta inkluderas också när ai_model är meshy-6, förutom vid texture_resolution: 8k (då produceras ingen emissionskarta). meshy-6-lite, meshy-7.1 och latest producerar ingen emissionskarta.

Upplösning för basfärgstexturen. Antingen 2k (2048×2048), 4k (4096×4096) eller 8k (8192×8192). Högre upplösningar fångar mer ytdetalj. Gäller endast för refine-mode.

Använd texture_resolution istället — motsvarar texture_resolution: "4k". När båda anges har texture_resolution företräde.

Ange en ytterligare textprompt för att styra teturbeläggningsprocessen. Max 800 tecken.

Ange en 2d-bild för att styra teturbeläggningsprocessen. Vi stöder för närvarande formaten .jpg, .jpeg och .png.

Det finns två sätt att ange bilden:

• Publikt tillgänglig URL: En URL som är tillgänglig från det publika internet
• Data URI: En base64-kodad data-URI av bilden. Exempel på en data-URI: data:image/jpeg;base64,<din base64-kodade bilddata>

ID för modellen som ska användas för refine.

Tillgängliga värden:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (föråldrad): använd meshy-7.1 istället.

Utelämna denna parameter för att ärva modellen som användes av preview-tasken, vilket håller en preview och dess refine på samma modell från start till slut. Skicka ett explicit värde för att åsidosätta detta arv.

När satt till true kommer det inmatade innehållet automatiskt att granskas för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks kommer tasken inte att gå vidare till generering.

Både texten från texture_prompt och bilden från texture_image_url kommer att granskas.

Tar bort highlights och skuggor från basfärgstexturen, vilket ger ett renare resultat som fungerar bättre med anpassade ljussättningar.

Anger vilka 3D-filformat som ska inkluderas i resultatet. Endast de begärda formaten kommer att genereras och returneras, vilket kan minska tiden för att slutföra tasken. Om parametern utelämnas inkluderas alla stödda format.

Tillgängliga värden: glb, obj, fbx, stl, usdz, 3mf

När satt till true renderar tasken dessutom en version av förhandsvisningen med transparent bakgrund (RGBA) och returnerar den som alpha_thumbnail_url i GET-svaret. Det befintliga fältet thumbnail_url förblir oförändrat.

När satt till true använder tjänsten AI-syn för att automatiskt uppskatta objektets verkliga höjd och ändra storlek på modellen därefter. Origo kommer att sättas till bottom som standard om inte origin_at anges explicit.

Begäran var inte godtagbar. Vanliga orsaker:

• Ogiltigt task-ID: preview_task_id är ogiltigt eller finns inte.
• Task inte redo: Preview-tasken har ännu inte lyckats.
• Modellmissmatchning: Preview-taskens AI-modell är inkompatibel med den begärda refine-modellen.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna task.

Preview-tasken som angavs med preview_task_id hittades inte.

Du har överskridit din hastighetsgräns.

Unik identifierare för den Text till 3D-uppgift som ska hämtas.

ID:t för den Text till 3D-uppgift som ska tas bort.

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtet är 100 objekt.

Fält att sortera efter.

Tillgängliga värden:

• +created_at: Sortera efter skapandetid i stigande ordning.
• -created_at: Sortera efter skapandetid i fallande ordning.

Unik identifierare för Text till 3D-uppgiften som ska streamas.

Unik identifierare för uppgiften. Även om vi använder ett k-sorterbart UUID för uppgifts-id som implementationsdetalj bör du inte göra några antaganden om id:ts format.

Typ av Text till 3D-uppgift. Möjliga värden är text-to-3d-preview för uppgifter i preview-steget och text-to-3d-refine för uppgifter i refine-steget.

Nedladdningsbar URL till den texturerade 3D-modellfilen som genererats av Meshy. Egenskapen för ett format utelämnas om formatet inte genererats, istället för att returnera en tom sträng.

Detta är den omodifierade prompt som användes för att skapa uppgiften.

Bibehålls för bakåtkompatibilitet. Detta fält har ingen funktionell påverkan på genererade modeller.

Den omodifierade art_style som användes för att skapa preview-uppgiften. Stöds inte av Meshy-6.

Bibehålls för bakåtkompatibilitet. Detta fält har ingen funktionell påverkan på genererade modeller.

Ytterligare textprompt som tillhandahålls för att styra textureringsprocessen under refine-steget.

Föråldrad; läs geometry_resolution istället.

Ultra-nivån som preview-uppgiften kördes i (2k eller 4k); utelämnas för standard.

Nedladdningsbar URL till texturbilden som användes för att styra textureringsprocessen.

Nedladdningsbar URL till miniatyrbilden av modellfilen.

Nedladdningsbar URL till en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast med när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsvisningen renderades utan problem; annars utelämnas detta fält.

Nedladdningsbar URL till förhandsvisningsvideon. Kommer att tas bort i en framtida version.

Uppgiftens progress. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0. När uppgiften har lyckats blir den 100.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften ännu inte har startat kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften ännu inte är slutförd kommer denna egenskap att vara 0.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

En array av texture URL-objekt som genereras från uppgiften. Vanligtvis innehåller denna bara ett texture URL-objekt. Varje texture URL har följande egenskaper:

Antalet föregående uppgifter.

Felinformation för misslyckade uppgifter. Se Fel för hela referensen av task_error-objektet.

Antalet credits som förbrukats av denna uppgift. Finns med när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).