Text till 3D API

Detta fält ska sättas till "preview" när du skapar en förhandsgranskningsuppgift.

Beskriv vilken typ av objekt 3D-modellen är. Högst 600 tecken.

Ange typen av 3D-nätgenerering.

Tillgängliga värden:

• standard: Vanlig 3D-nätgenerering med hög detaljnivå.
• lowpoly: Genererar low-poly-nät optimerat för renare polygoner.

ID för modellen som ska användas. Tillgängliga värden: meshy-5, meshy-6, latest (Meshy 6).

Styr om remesh-fasen ska aktiveras. När den är satt till false returnerar API:et direkt det triangulära nätet med högst precision.

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

Fältet symmetry_mode styr symmetribeteende under modellgenereringsprocessen.

De giltiga värdena är:

• off: Inaktiverar symmetri.
• auto: Avgör automatiskt och tillämpar symmetri baserat på inmatningsgeometri.
• on: Tvingar 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. Begäranden som använder Meshy-6 ignorerar art_style, och vissa kombinationer kan orsaka fel. Tillgängliga värden: realistic, sculpture.

När den är satt till true granskas inmatningsinnehållet automatiskt för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks fortsätter uppgiften inte till generering.

Texten från prompt kommer att granskas.

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

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

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

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

Begäran 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.
• För lång prompt: prompt överskrider teckengränsen.

Autentisering 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 anges till "refine" när du skapar en förfiningsuppgift.

Motsvarande ID för förhandsvisningsuppgiften.

Statusen för den angivna förhandsvisningsuppgiften måste vara SUCCEEDED.

Generera PBR-mappar (metallic, roughness, normal) utöver basfärgen. En emission map inkluderas också när ai_model är meshy-6 eller latest.

Generera basfärgstexturen i 4K-upplösning (4096×4096) för högre detaljrikedom.

Ange en ytterligare textprompt för att styra textureringsprocessen. Högst 600 tecken.

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

Det finns två sätt att tillhandahålla bilden:

• Publikt åtkomlig URL: En URL som är åtkomlig från det publika internet
• Data URI: En base64-kodad Data URI för bilden. Exempel på en Data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID för modellen som ska användas för förfining. Tillgängliga värden: meshy-5, meshy-6, latest (Meshy 6).

När detta anges till true granskas indatainnehållet automatiskt för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks fortsätter uppgiften inte till generering.

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

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

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

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

När detta anges 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 ändras inte.

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

Begäran var ogiltig. Vanliga orsaker:

• Ogiltigt uppgifts-ID: preview_task_id är ogiltigt eller finns inte.
• Uppgiften är inte redo: Förhandsvisningsuppgiften har inte lyckats ännu.
• Modellinkompatibilitet: Förhandsvisningsuppgiftens AI-modell är inkompatibel med den begärda förfiningsmodellen.

Autentisering misslyckades. Kontrollera din API-nyckel.

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

Förhandsvisningsuppgiften som anges av 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 Text till 3D-uppgiften som ska tas bort.

Sidnummer för paginering.

Gräns för sidstorlek. Högsta tillåtna är 50 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 strömmas.

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

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

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

Detta är den oförändrade 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 oförändrade art_style som användes för att skapa förhandsgranskningsuppgiften. Stöds inte av Meshy-6.

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

Ytterligare text-prompt som tillhandahålls för att vägleda textureringsprocessen under förfiningssteget.

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

Nedladdningsbar URL till miniatyrbilden för modellfilen.

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

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

Uppgiftens progress. Om uppgiften inte har startats ännu kommer denna egenskap att vara 0. När uppgiften har slutförts framgångsrikt blir detta 100.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startats ännu 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 inte är slutförd ännu kommer denna egenskap att vara 0.

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

En array med textur-URL-objekt som genereras från uppgiften. Normalt innehåller detta endast ett textur-URL-objekt. Varje textur-URL har följande egenskaper:

Antalet föregående uppgifter.

Feldetaljer för misslyckade uppgifter. Se Fel för fullständig objektreferens för task_error.

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