Text to 3D API

Ang field na ito ay dapat na "preview" kapag gumagawa ng preview task.

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

Tukuyin ang uri ng 3D mesh generation.

Mga available na value:

• standard: Regular na high-detail 3D mesh generation.
• smart-topology: Piliin ang Smart Topology model gamit ang ai_model (meshy-t2).
• lowpoly (deprecated): Naglilikha 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, natural na hiwalay na mga bahagi, triangle output, at isang face count na maitatakda mo gamit ang target_polycount.

Nagpapagana ng Ultra generation para sa mas mataas na kalidad na heometriya na may mas pinong detalye sa ibabaw. Mas matagal ang pagbuo at nagdaragdag ng 5 credits.

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

Target na bilang ng polygons (faces) sa output. Ang aktwal na bilang ay maaaring mag-iba mula sa target depende sa heometriya.

Ang target_polycount ay may bisa sa dalawang independiyenteng kaso:

• Remesh — kasama ang should_remesh: true sa isang standard model. Ang mesh ay ni-remesh (decimated) sa humigit-kumulang na bilang na ito. Saklaw na 100 hanggang 300,000, default na 30,000. Kapag naitakda ang decimation_mode, ito ang mananaig at hindi ginagamit ang target_polycount.
• Smart Topology — kasama ang model_type: smart-topology at ai_model: meshy-t2. Ang model ay direktang binubuo sa bilang ng face na ito; walang tumatakbong remesh at hindi kinakailangan ang should_remesh. Saklaw na 100 hanggang 15,000, default na 4,000.

Deprecated. Ang parameter na ito ay hindi na nakaaapekto sa output.

Ang field na symmetry_mode ay kinokontrol ang paggana ng simetriya sa proseso ng generation ng model.

Ang mga valid na value ay:

• off: Hindi pinagana ang simetriya.
• auto: Awtomatikong tinutukoy at ikinakapit 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: Buuin ang model sa A pose.
• t-pose: Buuin ang model sa T pose.
• "" (empty string): Walang partikular na pose na ikakapit.

Gamitin ang pose_mode sa halip. Kung buuin ba ang 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 errors. Mga available na value: realistic, sculpture.

Kapag itinakda sa true, ang input content ay awtomatikong susuriin para sa potensyal na nakapipinsalang nilalaman. Kapag natukoy ang nakapipinsalang nilalaman, 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 mabawasan ang oras ng pagkumpleto ng task. Kapag hindi ito isinama, lahat ng suportadong format ay isasama.

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

Kapag itinakda sa true, ang task ay bubuo pa ng bersyon ng preview na may transparent-background (RGBA) 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 real-world na taas ng bagay at ayusin ang laki ng model alinsunod dito. Ang origin ay magiging bottom bilang default maliban kung hayagang itinakda ang origin_at.

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

• Nawawalang parameter: Ang isang kinakailangang parameter (hal., prompt, mode) ay nawawala.
• Di-wastong parameter: Ang art_style ay hindi isa sa mga pinapayagang value.
• Masyadong mahaba ang prompt: Ang prompt ay lumampas sa limitasyon ng karakter.

Nabigo ang authentication. Mangyaring suriin ang iyong API key.

Hindi sapat ang credits para maisagawa ang task na ito.

Lumampas ka sa iyong rate limit.

Ang field na ito ay dapat na naka-set 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 nabubuo). Ang meshy-7 (at latest) ay hindi gumagawa ng emission map.

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 ng surface. Naaangkop lamang sa refine mode.

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

Magbigay ng karagdagang text prompt upang gabayan ang proseso ng pag-te-texture. Maximum na 800 characters.

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

Mayroong dalawang paraan upang ibigay ang larawan:

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

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

Kapag naka-set sa true, awtomatikong susuriin ang input content para sa posibleng mapaminsalang nilalaman. Kung may natukoy na mapaminsalang nilalaman, hindi magpapatuloy ang task sa generation.

Pareho ang text mula sa texture_prompt at ang larawan mula sa texture_image_url ay susuriin.

Inaalis ang mga highlight at anino mula sa base color texture, na nagbubunga ng mas malinis na resulta na mas mahusay gumana sa custom na lighting setups.

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

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

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

Kapag naka-set sa true, ginagamit ng serbisyo ang AI vision upang awtomatikong tantiyahin ang real-world na taas ng object at i-resize ang model nang naaayon. Ang origin ay magiging bottom bilang default maliban kung tahasang naka-set ang origin_at.

Hindi katanggap-tanggap ang request. Karaniwang mga sanhi:

• Invalid task ID: Ang preview_task_id ay hindi wasto o hindi umiiral.
• Task not ready: Ang preview task ay hindi pa nagtagumpay.
• Model mismatch: 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 tinukoy ng preview_task_id.

Nalagpasan mo na ang 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 ng laki ng pahina. Ang pinakamataas na pinapayagan ay 50 na item.

Field na gagamitin sa pag-aayos.

Mga available na value:

• +created_at: Iayos ayon sa oras ng paggawa nang paakyat (ascending).
• -created_at: Iayos ayon sa oras ng paggawa nang pababa (descending).

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

Natatanging identifier para sa task. Bagaman gumagamit kami ng k-sortable UUID para sa mga task id bilang detalye ng implementasyon, hindi ka dapat 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 mga preview stage task at text-to-3d-refine para sa mga refine stage task.

Downloadable URL patungo sa textured na 3D model file na ginawa ng Meshy. Ang property para sa isang format ay hindi isasama kung hindi nabuo ang format, 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 paggana 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 paggana ng mga nabuong model.

Karagdagang text prompt na ibinigay upang gabayan ang proseso ng pag-tetexture sa panahon ng refine stage.

Ipinapakita ang value ng ultra_mode na ginamit noong nilikha ang preview task. Naipapakita lang ito para sa meshy-7 (o latest) na mga preview task na tahasang nagtakda ng ultra_mode; hindi isinasama kung hindi.

Downloadable URL patungo sa texture image na ginamit upang gabayan ang proseso ng pag-tetexture.

Downloadable URL patungo sa thumbnail image ng model file.

Downloadable URL patungo sa bersyon na may transparent background (RGBA) ng thumbnail_url. Naipapakita lang ito kapag ang task ay nilikha gamit ang alpha_thumbnail: true at matagumpay na na-render ang transparent na preview; kung hindi, hindi isasama ang field na ito.

Downloadable URL patungo sa preview video. Aalisin sa susunod na release.

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

Katayuan 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, iisang texture URL object lang ang laman nito. Ang bawat texture URL ay may mga sumusunod na 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 ginamit ng task na ito. Naipapakita 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).