Text till 3D API

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

Beskriv vad för slags objekt 3D-modellen är. Maximalt 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. De tillgängliga värdena beror på model_type.

Standardgenerering (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

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

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

Aktiverar Ultra-generering för geometri med högre precision och finare ytdetaljer. Genereringen tar längre tid och kostar 5 extra credits.

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 får effekt i två oberoende fall:

• Remesh — med should_remesh: true på en standard-modell. Nätet remeshas (decimeras) till ungefär detta antal. Intervall 100 till 300 000, standard 30 000. Om decimation_mode är satt har den 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 krä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.

Giltiga värden är:

• off: Inaktiverar symmetri.
• auto: Avgör och tillämpar automatiskt symmetri baserat på indatageometri.
• on: Framtvingar 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 det inmatade innehållet automatiskt att granskas för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks fortsätter inte uppgiften 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 uppgiftens slutförandetid. Om detta utelämnas ingår 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örhandsgranskningen 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 ändrar storlek på modellen därefter. Origo kommer som standard att vara bottom om inte origin_at uttryckligen anges.

Förfrågan var inte godtagbar. 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.

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 förfiningsuppgift skapas.

ID:t för motsvarande förhandsgranskningsuppgift.

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

Generera PBR-mappar (metallic, roughness, normal) utöver bas­färgen. En emission-mapp inkluderas också när ai_model är meshy-6, förutom vid texture_resolution: 8k (ingen emission-mapp genereras då). meshy-7 (och latest) genererar ingen emission-mapp.

Texturupplösning för basfärgen. En av 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 textureringsprocessen. Maximalt 800 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 ange bilden:

• Publikt tillgänglig 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 den modell som ska användas för förfining. Tillgängliga värden: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

När detta sätts till true kommer det inmatade 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.

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 genereras och returneras, vilket kan minska uppgiftens genomförandetid. Om parametern 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örhandsgranskningen 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 vara bottom om inte origin_at uttryckligen anges.

Begäran kunde inte accepteras. Vanliga orsaker:

• Ogiltigt uppgifts-ID: preview_task_id är ogiltigt eller existerar inte.
• Uppgiften är inte klar: Förhandsgranskningsuppgiften har ännu inte lyckats.
• Modellmatchning saknas: Förhandsgranskningsuppgiftens AI-modell är inkompatibel med den begärda förfiningsmodellen.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Förhandsgranskningsuppgiften som anges av preview_task_id hittades inte.

Du har överskridit din hastighetsgräns.

Unik identifierare för Text till 3D-uppgiften att hämta.

ID för Text till 3D-uppgiften som ska tas bort.

Sidnummer för paginering.

Sidstorleksgräns. Maximalt 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 att strömma.

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

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

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

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

Bibehållen 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 förhandsgranskningsuppgiften. Inte stödd av Meshy-6.

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

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

Återspeglar ultra_mode-värdet som förhandsgranskningsuppgiften skapades med. Endast närvarande för meshy-7 (eller latest) förhandsgranskningsuppgifter som uttryckligen satte ultra_mode; utelämnas annars.

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

Nedladdningsbar URL till miniatyrbilden av modellfilen.

Nedladdningsbar URL till en version av thumbnail_url med transparent bakgrund (RGBA). Endast närvarande 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.

Framsteg för uppgiften. Om uppgiften inte har startat ännu kommer denna egenskap att vara 0. När uppgiften har lyckats kommer detta att bli 100.

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

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

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

Status för uppgiften. Möjliga värden är en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

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

Antalet föregående uppgifter.

Felformationer för misslyckade uppgifter. Se Fel för fullständig referens till task_error-objektet.

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