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. 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, triangelutdata, och ett antal ytor som du kan ställa in med target_polycount.

Aktiverar Ultra-generering för geometri med högre kvalitet 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.

Önskat antal polygoner (ytor) i utdatan. Det faktiska antalet kan avvika från målet beroende på geometrin.

target_polycount gäller 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 utdatan.

Fältet symmetry_mode styr symmetribeteende under modellgenereringsprocessen.

De giltiga värdena är:

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

Ange pose mode för den genererade modellen.

Tillgängliga värden:

• a-pose: Genererar modellen i en A-pose.
• t-pose: Genererar 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 kommer uppgiften inte att fortsätta till generering.

Texten från prompt kommer att granskas.

Anger vilka 3D-filformat som ska ingå i utdatan. Endast de begärda formaten genereras och returneras, vilket kan minska uppgiftens genomförandetid. När den 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 preview 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-vision för att automatiskt uppskatta objektets verkliga höjd och ändrar storlek på modellen därefter. Origo kommer som standard vara 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.
• Prompt för lång: 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 refine task skapas.

Motsvarande preview task-id.

Status för den angivna preview task 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, förutom vid texture_resolution: 8k (ingen emission map produceras då). meshy-7 (och latest) producerar inte någon emission map.

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". Om båda anges har texture_resolution företräde.

Ange en ytterligare textprompt för att styra textureringsprocessen. Max 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 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-5, meshy-6, meshy-7, latest (Meshy 7).

Utelämna denna parameter för att ärva modellen som användes av preview task, vilket håller en preview och dess refine på samma modell hela vägen. Skicka ett explicit värde för att åsidosätta detta arv.

När det sätts till true kommer det angivna innehållet automatiskt att granskas för potentiellt skadligt innehåll. Om skadligt innehåll upptäcks kommer tasken 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 kommer att genereras och returneras, vilket kan minska tiden det tar att slutföra tasken. Om parametern utelämnas inkluderas alla format som stöds.

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

När det sätts till true renderar tasken 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 det 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 task-id: preview_task_id är ogiltigt eller finns inte.
• Task inte redo: Preview task har ännu inte lyckats.
• Modellmissmatchning: Preview tasken AI-modell är inkompatibel med den begärda refine-modellen.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Preview tasken som angavs 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 den Text till 3D-uppgift som ska tas bort.

Sidnummer för paginering.

Sidstorleksgräns. Maximalt tillåtet ä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 en k-sorterbar 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 genereras, istä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 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.

Återspeglar värdet på ultra_mode som preview-uppgiften skapades med. Finns endast med för meshy-7- (eller latest-) preview-uppgifter som uttryckligen angav ultra_mode; utelämnas i annat fall.

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

Nedladdningsbar URL till miniatyrbilden för 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 korrekt; 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 startats 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 startats 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 ännu inte är avslutad 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 endast 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 för objektet task_error.

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