Text to 3D API

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

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

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, ire-retire sa Oktubre 30, 2026): Bumubuo ng low-poly na mesh na naka-optimize para sa mas malinis na polygons. Inirerekomenda naming Meshy T2 sa halip: smart-topology na may meshy-t2.

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

Standard na generation (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (deprecated): gamitin ang meshy-7.1 sa halip.

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 face count na maaari mong itakda gamit ang target_polycount.

Geometry generation pass. Pinapatakbo ng 2k ang Ultra pass sa 2048³; pinapatakbo ito ng 4k sa 4096³ para sa pinaka-detalyadong surface.

Mga available na value: standard, 2k, 4k

Gamitin ang geometry_resolution sa halip. Ang ultra_mode: true ay katumbas ng geometry_resolution: "2k".

Kinokontrol kung paganahin 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. Maaaring lumihis ang aktwal na bilang mula sa target depende sa heometriya.

Nagkakabisa ang target_polycount sa dalawang independiyenteng kaso:

• Remesh — na may should_remesh: true sa isang standard na model. Ang mesh ay nire-remesh (decimated) sa humigit-kumulang na bilang na ito. Saklaw na 100 hanggang 300,000, default na 30,000. Kung naitakda ang decimation_mode, ito ang mangunguna at hindi pinapansin ang target_polycount.
• Smart Topology — na may model_type: smart-topology at ai_model: meshy-t2. Direktang nabubuo ang model sa face count na ito; walang tumatakbong remesh at hindi kinakailangan ang should_remesh. Saklaw na 100 hanggang 15,000, default na 4,000.

Deprecated. Hindi na nakakaapekto ang parameter na ito sa output.

Kinokontrol ng field na symmetry_mode ang simetriya na pag-uugali sa panahon ng proseso ng pagbuo ng model.

Ang mga valid na value ay:

• off: Dine-disable ang simetriya.
• auto: Awtomatikong tinutukoy at inilalapat ang simetriya batay sa input na heometriya.
• 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 ang pose_mode sa halip. Kung bubuo ang model sa A/T pose.

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

Kapag itinakda sa true, awtomatikong sususuriin ang input content para sa potensyal na nakakapinsalang nilalaman. Kung may natuklasang nakakapinsalang 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 magpaikli sa oras ng pagkumpleto ng task. Kapag naiwan na blangko, isinasama ang lahat ng suportadong format.

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

Kapag itinakda sa true, karagdagang mag-re-render ang task ng bersyon na transparent-background (RGBA) ng preview at ibabalik ito bilang alpha_thumbnail_url sa GET response. Hindi nagbabago ang kasalukuyang field na thumbnail_url.

Kapag itinakda sa true, gagamitin ng serbisyo ang AI vision para awtomatikong tantyahin ang real-world na taas ng bagay at baguhin ang laki ng model alinsunod dito. Ang origin ay magiging bottom bilang default maliban kung malinaw na itinakda ang origin_at.

Hindi katanggap-tanggap ang request. Karaniwang mga dahilan:

• Nawawalang parameter: Isang kinakailangang parameter (hal., prompt, mode) ang nawawala.
• Hindi valid na parameter: Hindi isa ang art_style sa mga pinapayagang value.
• Masyadong mahaba ang prompt: Lumampas ang prompt sa limitasyon ng karakter.
• Hindi suportadong model para sa low poly: Hindi sinusuportahan ng ai_model: "meshy-6-lite" ang model_type: "lowpoly".
• Hindi suportadong model para sa Ultra: Nangangailangan ang geometry_resolution ng meshy-7.1 o latest.

Nabigo ang authentication. Pakisuri ang iyong API key.

Hindi sapat na credits para isagawa ang task na ito.

Lumampas ka 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 binigay na preview task ay dapat na SUCCEEDED.

Bumuo ng PBR Maps (metallic, roughness, normal) bilang karagdagan sa base color. Kasama rin ang emission map kapag ang ai_model ay meshy-6, maliban sa texture_resolution: 8k (walang emission map na gagawin). Ang meshy-6-lite, meshy-7.1, at latest ay hindi gumagawa ng emission map, gayundin ang refine ng isang meshy-t2 preview na hindi nagtatakda ng ai_model.

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

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

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

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

Maximum na laki ng file: 20 MB.

May dalawang paraan upang ibigay ang larawan:

• Publicly accessible URL: Isang URL na accessible mula sa public 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 modelo na gagamitin para sa refining.

Mga magagamit na value:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (deprecated): gamitin ang meshy-7.1 sa halip.

Alisin ang parameter na ito upang magmana ng modelo na ginamit ng preview task, na nagpapanatili sa isang preview at sa refine nito sa parehong modelo mula simula hanggang katapusan. Maglagay ng explicit na value upang i-override ang pagmamanang iyon.

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

Parehong susuriin ang text mula sa texture_prompt at ang larawan mula sa texture_image_url.

Inaalis ang mga highlight at shadow mula sa base color texture, na nagbubunga ng mas malinis na resulta na mas mahusay na gumagana sa ilalim ng custom na lighting setup.

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

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

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

Kapag itinakda sa true, gumagamit ang serbisyo ng AI vision upang awtomatikong tantyahin ang real-world na taas ng object at i-resize ang modelo ayon dito. Ang origin ay magde-default sa bottom maliban kung explicit na itinakda ang origin_at.

Hindi katanggap-tanggap ang request. Mga karaniwang sanhi:

• Invalid na task ID: Ang preview_task_id ay invalid o hindi umiiral.
• Hindi pa handa ang task: Hindi pa nagtatagumpay ang preview task.
• Hindi tugmang modelo: Hindi tugma ang AI model ng preview task sa hiniling na refine model.
• Hindi suportadong modelo para sa remove_lighting: Itinakda ang remove_lighting kasama ang ai_model: "meshy-6-lite".

Nabigo ang authentication. Mangyaring suriin ang iyong API key.

Hindi sapat na credits upang maisagawa ang task na ito.

Hindi natagpuan ang preview task na tinukoy ng preview_task_id.

Nalampasan 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 maximum na pinapayagan ay 100 na items.

Field na gagamitin sa pag-sort.

Mga available na halaga:

• +created_at: Pagsunud-sunurin ayon sa oras ng paggawa nang pataas (ascending).
• -created_at: Pagsunud-sunurin ayon sa oras ng paggawa nang pababa (descending).

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

Natatanging identifier para sa task. Bagama't gumagamit kami ng k-sortable UUID para sa mga task id bilang implementation detail, 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 task sa preview stage at text-to-3d-refine para sa mga task sa refine stage.

Downloadable URL sa textured na 3D model file na nabuo ng Meshy. Ang property para sa isang format ay aalisin kung hindi nabuo ang format, sa halip na magbalik ng isang walang-lamang string.

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

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

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

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

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

Deprecated na; basahin na lamang ang geometry_resolution.

Ang Ultra tier kung saan pinatakbo ang preview task (2k o 4k); aalisin para sa standard.

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

Downloadable URL sa thumbnail image ng model file.

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

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

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

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

Timestamp kung kailan nagawa ang task, sa milliseconds.

Timestamp kung kailan natapos ang task, sa milliseconds. Kung hindi pa natatapos 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, naglalaman lamang ito ng isang texture URL object. Ang bawat texture URL ay may mga sumusunod na properties:

Ang bilang ng mga naunang task.

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

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