Text till 3D API

Detta fält ska ställas in till "preview" när du skapar en förhandsgranskningsuppgift.

Beskriv vad för slags objekt 3D-modellen är. Max 600 tecken.

Specificera typen av 3D nätgenerering.

Tillgängliga värden:

• standard: Vanlig högdetaljnätgenerering.
• smart-topology: Välj Smart Topology-modellen med ai_model (meshy-t2).
• lowpoly (föråldrad): Genererar ett låg-poly nät optimerat för renare polygoner. Vi rekommenderar att använda 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-5, meshy-6, meshy-7, latest (Meshy 7)

Smart Topology generering (model_type: smart-topology):

• meshy-t2 (standard): Smart Topology-modellen — renare topology, nativt separerade delar, triangulär utgång, och ett ansiktsantal du kan sätta med target_polycount.

Aktiverar Ultra-generering för högre trogenhet på geometri med finare ytdetalj. Generering tar längre tid och kräver 5 credits.

Kontrollerar om man ska aktivera remesh-fasen. För den bästa kvaliteten rekommenderar vi att ställa should_remesh till false.

Målad antal polygoner (ytor) i utgången. Det faktiska antalet kan avvika från målet beroende på geometrin.

target_polycount träder i kraft i två oberoende fall:

• Remesh — med should_remesh: true på en standard-modell. Modellen är remeshed (decimerad) till ungefär detta antal. Intervall 100 till 300,000, standard 30,000. Om decimation_mode är inställd, går den före och target_polycount ignoreras.
• Smart Topology — med model_type: smart-topology och ai_model: meshy-t2. Modellen genereras direkt vid detta ytantalsantal; inga 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 utgången.

symmetry_mode-fältet kontrollerar symmetrins beteende under modellgenereringsprocessen.

De giltiga värdena är:

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

Specificera poseläget för den genererade modellen.

Tillgängliga värden:

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

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

Ej stödd av Meshy-6. Förfrågningar med Meshy-6 kommer att ignorera art_style, och vissa kombinationer kan orsaka fel. Tillgängliga värden: realistic, sculpture.

När den är inställd på true, kommer innehållet automatiskt att kontrolleras 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.

Specificerar vilka 3D-filformat som ska inkluderas i utgången. Endast de begärda formaten kommer att genereras och returneras, vilket kan minska slutförandetiden för uppgiften. När det utelämnas inkluderas alla stödda format.

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

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

När den är inställd på true, använder tjänsten AI-vision för att automatiskt uppskatta objektets verkliga höjd och ändra storleken på modellen därefter. Ursprung kommer att standardinställas till bottom såvida inte origin_at uttryckligen är angivet.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: En krävd 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 överstiger teckengränsen.

Autenticering misslyckades. Kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

Detta fält ska sättas till "refine" när man skapar en förfina uppgift.

Det motsvarande förhandsgranskningsuppgifts-ID:t.

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

Generera PBR-mappar (metaller, ojämnhet, normal) utöver grundfärgen. En emissionskarta ingår också när ai_model är meshy-6, förutom vid texture_resolution: 8k (ingen emissionskarta produceras). meshy-7 (och latest) producerar inte en emissionskarta.

Grundfärgs texturupplösning. En av 2k (2048×2048), 4k (4096×4096), eller 8k (8192×8192). Högre upplösningar fångar mer ytdetalj. Gäller endast refine-läge.

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

Ange en extra textprompt för att guida textureringsprocessen. Max 600 tecken.

Tillhandahåll en 2D-bild för att guida textureringsprocessen. Vi stöder för närvarande .jpg, .jpeg, och .png format.

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

• Offentligt tillgänglig URL: En URL som är tillgänglig från det offentliga 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 förfining. Tillgängliga värden: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

När den är inställd på true, kommer innehållet automatiskt att kontrolleras 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 höjdpunkter och skuggor från grundfärgstexturen, vilket ger ett renare resultat som fungerar bättre under anpassade ljusinställningar.

Specificerar vilka 3D-filformat som ska inkluderas i utgången. Endast de begärda formaten kommer att genereras och returneras, vilket kan minska slutförandetiden för uppgiften. När det utelämnas inkluderas alla stödda format.

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

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

När den är inställd på true, använder tjänsten AI-vision för att automatiskt uppskatta objektets verkliga höjd och ändra storleken på modellen därefter. Ursprung kommer att standardinställas till bottom såvida inte origin_at uttryckligen är angivet.

Begäran var oacceptabel. Vanliga orsaker:

• Ogiltigt uppgifts-ID: preview_task_id är ogiltig eller finns inte.
• Uppgift inte redo: Förhandsgranskningsuppgiften har inte lyckats än.
• Modellmismatch: Förhandsgranskningsuppgiftens AI-modell är inkompatibel med den begärda förfiningsmodellen.

Autenticering misslyckades. Kontrollera din API-nyckel.

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

Förhandsgranskningsuppgiften specificerad av preview_task_id hittades inte.

Du har överskridit din hastighetsgräns.

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

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

Sidnummer för paginering.

Sidstorleksbegränsning. Maximal tillåten ä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-uppgift som ska strömmas.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar 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örhandsgranskningsstegs-uppgifter och text-to-3d-refine för förfiningsstegs-uppgifter.

Nedladdningsbar URL till den texturerade 3D-modellfilen som genereras 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 omodifierad prompt som användes för att skapa uppgiften.

Kvarstår för bakåtkompatibilitet. Detta fält har ingen funktionell inverkan på genererade modeller.

Det omodifierade art_style som användes för att skapa förhandsgranskningsuppgiften. Ej stödd av Meshy-6.

Kvarstår för bakåtkompatibilitet. Detta fält har ingen funktionell inverkan på genererade modeller.

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

Återger 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 med transparent bakgrund (RGBA) av thumbnail_url. 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 release.

Framsteg för uppgiften. Om uppgiften inte har börjat än, kommer denna egenskap att vara 0. När uppgiften har lyckats, kommer denna att bli 100.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startat än, 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 än, 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.

Feldetaljer för misslyckade uppgifter. Se Fel för full task_error-objektreferens.

Antalet credits som konsumeras av denna uppgift. Närvarande när uppgiftsstatusen är PENDING, IN_PROGRESS, eller SUCCEEDED. Returnerar 0 för FAILED uppgifter (credits återbetalas vid misslyckande).