Text till 3D API

Detta fält ska sättas till "preview" vid skapande av en förhandsgranskningsuppgift.

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

Ange typen av 3D-nätgenerering.

Tillgängliga värden:

• standard: Vanlig 3D-nätgenerering med hög detaljnivå.
• smart-topology: Välj en Smart Topology-modell med ai_model (meshy-t2 eller meshy-t2.5).
• lowpoly (föråldrad, utfasas 30 oktober 2026): Genererar low-poly-nät optimerat för renare polygoner. Vi rekommenderar Meshy T2.5 istället: smart-topology med meshy-t2.5.

ID för modellen som ska användas. De tillgängliga värdena 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: Smart Topology-modellen — renare topology, naturligt separerade delar, triangelutmatning och ett antal ytor som du kan ställa in med target_polycount.
• meshy-t2.5 (standard): Skarpare detaljer för spelassets. Triangelutmatning och ett antal ytor som du kan ställa in med target_polycount.

Genereringspass för geometri. 2k kör Ultra-passet på 2048³; 4k kör det på 4096³ för finaste ytdetalj.

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 ställa in should_remesh till false.

Målvärde för antal polygoner (ytor) i utmatningen. Det faktiska antalet kan avvika från målvärdet beroende på geometrin.

target_polycount har 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 inställt har det prioritet och target_polycount ignoreras.
• Smart Topology — med model_type: smart-topology och ai_model meshy-t2 eller meshy-t2.5. Modellen genereras direkt med detta antal ytor; ingen remesh körs och should_remesh krävs inte. För meshy-t2: intervall 100 till 15 000, standard 4 000. För meshy-t2.5: intervall 100 till 30 000, standard 15 000.

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

Fältet symmetry_mode styr symmetribeteendet under modellgenereringsprocessen.

De giltiga värdena är:

• off: Inaktiverar symmetri.
• auto: Avgör och tillämpar symmetri automatiskt baserat på indatageometrin.
• 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 indatainnehå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 inkluderas i utmatningen. Endast de begärda formaten kommer att 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 ändras inte.

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

Förfrågan kunde inte godtas. 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.
• Prompten är för lång: prompt överskrider teckengränsen.
• Modell som inte stöds för low poly: ai_model: "meshy-6-lite" stöder inte model_type: "lowpoly".
• Modell som inte stöds 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.

ID:t för motsvarande preview-task.

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

Generera PBR-mappar (metallic, roughness, normal) utöver bas-färgen. En emission map inkluderas också när ai_model är meshy-6, förutom vid texture_resolution: 8k (ingen emission map genereras då). meshy-6-lite, meshy-7.1 och latest producerar ingen emission map, och inte heller en refine av en meshy-t2-preview som inte anger ai_model.

Upplösning för bas-färgstexturen. 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 texturerings processen. Max 800 tecken.

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

Maximal filstorlek: 20 MB.

Det finns två sätt att ange bilden på:

• 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,<your base64-encoded image data>

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 genomgående. Ange ett explicit värde för att åsidosätta det arvet.

När detta sätts till true kommer indatainnehå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 bas-färgstexturen, vilket ger ett renare resultat som fungerar bättre med anpassade ljussättningar.

Anger vilka 3D-filformat som ska inkluderas i utdata. Endast de begärda formaten genereras och returneras, vilket kan minska tasktens handläggningstid. När 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 tasken 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-synbaserad uppskattning för att automatiskt beräkna objektets verkliga höjd och ändra storlek på modellen i enlighet med detta. Origo sätts som standard till 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-tasken har ännu inte lyckats.
• Modellmatchning saknas: Preview-taskens AI-modell är inkompatibel med den begärda refine-modellen.
• Modell saknar stöd för remove_lighting: remove_lighting anges tillsammans med ai_model: "meshy-6-lite".

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

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

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 to 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-modellfil 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.

Behå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.

Behå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 styra textureringsprocessen under refine-steget.

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

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

Nedladdningsbar URL till den texturbild 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). Visas endast när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsvisningen renderades framgångsrikt; annars utelämnas detta fält.

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

Förloppet för uppgiften. 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 avslutades, i millisekunder. Om uppgiften ännu inte är klar kommer denna egenskap att vara 0.

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

En array med texture URL-objekt som genererats från uppgiften. Normalt 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 den fullständiga referensen till 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).