Text to 3D API

Dapat itakda ang field na ito sa "preview" kapag lumilikha ng preview task.

Ilarawan kung anong uri ng bagay ang 3D model. Maximum na 800 na character.

Tukuyin ang uri ng 3D mesh generation.

Mga available na value:

• standard: Regular na high-detail na 3D mesh generation.
• smart-topology: Piliin ang Smart Topology model gamit ang ai_model (meshy-t2).
• lowpoly (deprecated): Bumubuo ng low-poly mesh na na-optimize para sa mas malinis na polygons. Inirerekomenda naming gamitin ang smart-topology sa halip.

ID ng model na gagamitin. Ang mga available na value ay depende sa model_type.

Standard generation (model_type: standard):

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

Smart Topology generation (model_type: smart-topology):

• meshy-t2 (default): ang Smart Topology model — mas malinis na topology, likas na hiwalay na mga bahagi, triangle output, at bilang ng face na maaari mong itakda gamit ang target_polycount.

Nagbibigay-daan sa Ultra generation para sa mas mataas na fidelity na heometriya na may mas pinong detalye sa ibabaw. Mas matagal ang generation at nagdaragdag ng 5 credits.

Kinokontrol kung papaganahin ang remesh phase. Para sa pinakamataas na kalidad na model, inirerekomenda naming itakda ang should_remesh sa false.

Target na bilang ng polygons (faces) sa output. Ang aktwal na bilang ay maaaring maiba sa target depende sa heometriya.

Ang target_polycount ay may epekto sa dalawang independiyenteng kaso:

• Remesh — kapag should_remesh: true sa isang standard na model. Ang mesh ay ni-remesh (na-decimate) sa humigit-kumulang na bilang na ito. Saklaw na 100 hanggang 300,000, default na 30,000. Kung itinakda ang decimation_mode, ito ang magiging prayoridad at hindi pinapansin ang target_polycount.
• Smart Topology — kapag model_type: smart-topology at ai_model: meshy-t2. Ang model ay direktang bubuuin sa bilang ng face na ito; walang tatakbong remesh at hindi kailangan ang should_remesh. Saklaw na 100 hanggang 15,000, default na 4,000.

Deprecated. Ang parameter na ito ay wala nang epekto sa output.

Kinokontrol ng field na symmetry_mode ang gawi ng simetriya sa panahon ng proseso ng pagbuo ng model.

Ang mga valid na value ay:

• off: Hinahadlangan ang simetriya.
• auto: Awtomatikong tinutukoy at inilalapat ang simetriya batay sa input geometry.
• on: Ipinapatupad ang simetriya sa panahon ng generation.

Tukuyin ang pose mode para sa nabuong model.

Mga available na value:

• a-pose: Bumuo ng model sa A pose.
• t-pose: Bumuo ng model sa T pose.
• "" (walang laman na string): Walang partikular na pose na inilapat.

Gamitin sa halip ang pose_mode. Kung bubuo ng model sa A/T pose.

Hindi suportado ng Meshy-6. Ang mga request na gumagamit ng Meshy-6 ay hindi papansinin ang art_style, at ang ilang kombinasyon ay maaaring magdulot ng mga error. Mga available na value: realistic, sculpture.

Kapag itinakda sa true, awtomatikong susuriin ang input content para sa potensyal na nakakapinsalang content. Kung may natukoy na nakakapinsalang content, hindi magpapatuloy ang task sa generation.

Ang teksto mula sa prompt ang susuriin.

Tinutukoy kung aling mga 3D file format ang isasama sa output. Tanging ang mga hiniling na format lamang ang bubuuin at ibabalik, na maaaring magpababa sa oras ng pagkumpleto ng task. Kapag hindi isinama, lahat ng suportadong format ay isasama.

Mga available na value: glb, obj, fbx, stl, usdz, 3mf

Kapag itinakda sa true, karagdagang irerender ng task ang isang transparent-background (RGBA) na bersyon ng preview at ibabalik ito bilang alpha_thumbnail_url sa GET response. Ang umiiral na field na thumbnail_url ay hindi nagbabago.

Kapag itinakda sa true, gagamit ang serbisyo ng AI vision upang awtomatikong tantyahin ang aktwal na taas ng bagay sa totoong mundo at babaguhin ang laki ng model ayon dito. Ang origin ay magiging bottom bilang default maliban kung hayagang itinakda ang origin_at.

Ang request ay hindi katanggap-tanggap. Karaniwang mga dahilan:

• Kulang na parameter: Kulang ang isang kinakailangang parameter (hal., prompt, mode).
• Di-wastong parameter: Ang art_style ay hindi isa sa mga pinapayagang value.
• Masyadong mahaba ang prompt: Ang prompt ay lumagpas sa limitasyon ng character.

Nabigo ang authentication. Pakisuri ang iyong API key.

Hindi sapat ang credits upang isagawa ang task na ito.

Lumagpas ka na sa iyong rate limit.

Dapat itakda ang field na ito sa "refine" kapag gumagawa ng refine task.

Ang katumbas na preview task id.

Ang status ng ibinigay na preview task ay dapat na SUCCEEDED.

Gumawa ng PBR Maps (metallic, roughness, normal) bilang karagdagan sa base color. Isang emission map din ang isinasama kapag ang ai_model ay meshy-6, maliban sa texture_resolution: 8k (walang emission map na ginagawa). Ang meshy-7 (at latest) ay hindi gumagawa ng emission map.

Ang resolution ng base color texture. Isa sa 2k (2048×2048), 4k (4096×4096), o 8k (8192×8192). Ang mas mataas na resolution ay nakakakuha ng mas maraming detalye sa ibabaw. Naaangkop lamang sa refine mode.

Gamitin ang texture_resolution sa halip — katumbas ng texture_resolution: "4k". Kapag pareho itong itinakda, ang texture_resolution ang mananaig.

Magbigay ng karagdagang text prompt upang gabayan ang proseso ng pag-texture. Pinakamarami ay 800 na character.

Magbigay ng 2d na imahe upang gabayan ang proseso ng pag-texture. Kasalukuyan naming sinusuportahan ang mga format na .jpg, .jpeg, at .png.

May dalawang paraan upang magbigay ng imahe:

• Publicly accessible URL: Isang URL na naa-access mula sa pampublikong internet
• Data URI: Isang base64-encoded data URI ng imahe. Halimbawa ng data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID ng modelong gagamitin para sa refine. Mga available na value: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Alisin ang parameter na ito upang manahin ang modelong ginamit ng preview task, na nagpapanatili sa isang preview at sa refine nito sa parehong modelo mula simula hanggang wakas. Magpasa ng tahasang value upang i-override ang pagmanang iyon.

Kapag itinakda sa true, awtomatikong susuriin ang input content para sa potensyal na mapaminsalang nilalaman. Kung may natukoy na mapaminsalang nilalaman, hindi magpapatuloy ang task sa generation.

Parehong susuriin ang teksto mula sa texture_prompt at ang imahe mula sa texture_image_url.

Inaalis ang mga highlight at anino mula sa base color texture, na nagbubunga ng mas malinis na resulta na mas gumagana nang maayos sa custom na setup ng ilaw.

Tinutukoy kung aling mga 3D file format ang isasama sa output. Ang mga hiniling na format lamang ang gagawin at ibabalik, na maaaring magpababa sa oras ng pagkumpleto ng task. Kapag inalis, isinasama ang lahat ng suportadong format.

Mga available na value: glb, obj, fbx, stl, usdz, 3mf

Kapag itinakda sa true, ang task ay karagdagang nagre-render ng isang bersyon na may transparent na background (RGBA) ng preview at ibinabalik ito bilang alpha_thumbnail_url sa GET response. Ang umiiral na thumbnail_url field ay hindi nagbabago.

Kapag itinakda sa true, ginagamit ng serbisyo ang AI vision upang awtomatikong tantiyahin ang real-world na taas ng bagay at i-resize ang modelo alinsunod dito. Ang origin ay magde-default sa bottom maliban kung tahasang itinakda ang origin_at.

Hindi katanggap-tanggap ang request. Karaniwang mga dahilan:

• Invalid na task ID: Ang preview_task_id ay invalid o hindi umiiral.
• Hindi pa handa ang task: Ang preview task ay hindi pa nagtagumpay.
• Hindi tugmang modelo: Ang AI model ng preview task ay hindi tugma sa hiniling na refine model.

Nabigo ang authentication. Pakisuri ang iyong API key.

Hindi sapat na credits upang isagawa ang task na ito.

Hindi natagpuan ang preview task na tinutukoy ng preview_task_id.

Lumampas ka na sa iyong rate limit.

Natatanging identifier para sa Text to 3D task na kukunin.

Ang ID ng Text to 3D task na ide-delete.

Numero ng pahina para sa pagination.

Limitasyon sa laki ng pahina. Ang pinakamataas na pinapayagan ay 50 na item.

Field na gagamitin para sa pag-uuri.

Mga magagamit na halaga:

• +created_at: Ayusin batay sa oras ng paglikha nang paurong (ascending order).
• -created_at: Ayusin batay sa oras ng paglikha nang pababa (descending order).

Natatanging identifier para sa Text to 3D task na iso-stream.

Natatanging identifier para sa task. Bagama't gumagamit kami ng k-sortable UUID para sa task ids bilang detalye ng implementasyon, hindi dapat kayo gumawa ng anumang palagay tungkol sa format ng id.

Uri ng Text to 3D task. Ang mga posibleng value ay text-to-3d-preview para sa preview stage tasks at text-to-3d-refine para sa refine stage tasks.

Downloadable URL sa textured na 3D model file na binuo ng Meshy. Ang property para sa isang format ay ia-omit kung hindi ito nabuo sa halip na magbalik ng walang laman na string.

Ito ang hindi binagong prompt na ginamit upang likhain ang task.

Pinapanatili para sa backward compatibility. Ang field na ito ay walang epekto sa functionality ng mga nabuong model.

Ang hindi binagong art_style na ginamit upang likhain ang preview task. Hindi suportado ng Meshy-6.

Pinapanatili para sa backward compatibility. Ang field na ito ay walang epekto sa functionality ng mga nabuong model.

Karagdagang text prompt na ibinigay upang gabayan ang proseso ng texturing sa panahon ng refine stage.

Ipinapakita ang value ng ultra_mode na ginamit noong likhain ang preview task. Naroroon lamang para sa meshy-7 (o latest) na preview tasks na tahasang nagtakda ng ultra_mode; kung hindi, ito ay ia-omit.

Downloadable URL sa texture image na ginamit upang gabayan ang proseso ng texturing.

Downloadable URL sa thumbnail image ng model file.

Downloadable URL sa isang bersyon na may transparent na background (RGBA) ng thumbnail_url. Naroroon lamang kapag ang task ay ginawa gamit ang alpha_thumbnail: true at matagumpay na na-render ang transparent na preview; kung hindi, ia-omit ang field na ito.

Downloadable URL sa preview video. Aalisin sa hinaharap na release.

Progress ng task. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0. Kapag nagtagumpay na ang task, ito ay magiging 100.

Timestamp kung kailan sinimulan ang task, sa milliseconds. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0.

Timestamp kung kailan nilikha ang task, sa milliseconds.

Timestamp kung kailan natapos ang task, sa milliseconds. Kung hindi pa tapos ang task, ang property na ito ay magiging 0.

Status ng task. Ang mga posibleng value ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Isang array ng mga texture URL object na nabuo mula sa task. Karaniwan, ito ay naglalaman lamang ng isang texture URL object. Ang bawat texture URL ay may sumusunod na mga property:

Ang bilang ng mga naunang task.

Mga detalye ng error para sa mga nabigong task. Tingnan ang Errors para sa buong reference ng task_error object.

Ang bilang ng credits na naubos ng task na ito. Naroroon kapag ang status ng task ay PENDING, IN_PROGRESS, o SUCCEEDED. Nagbabalik ng 0 para sa mga FAILED na task (ang credits ay ire-refund kapag nabigo).