Auto Split API

Ang ID ng task na ang modelo nito ang hahatiin. Dapat SUCCEEDED ang status ng task. Gumagana ang mga sumusunod na uri ng task:

• Image to 3D
• Multi-Image to 3D
• Text to 3D, isang preview o refine task
• Retexture
• Remesh
• Convert
• Resize

Dapat nagawa ang modelo gamit ang Meshy 6 o Meshy 7, ibig sabihin, naka-set ang ai_model sa meshy-6-lite, meshy-6, meshy-7, meshy-7.1, o latest. Hindi suportado ang mga modelong Smart Topology (meshy-t2 at meshy-t2.5). Para sa refine, Retexture, Remesh, Convert, o Resize task, ang panuntunan ay nalalapat sa modelong pinanggalingan ng task. Ang Retexture, Remesh, Convert, o Resize task na gawa mula sa na-upload na modelo ay nagbabalik ng 400.

Maaaring magkaroon ang modelo ng hanggang 8,000,000 faces. Ang modelong may mas maraming faces ay nagbabalik ng 400. Sa ganoong pagkakataon, magpatakbo muna ng Remesh task dito, at ipadala ang ID ng Remesh task sa halip.

Maaari mong hatiin ang modelong may texture. Para mapanatili ang texture nito sa mga bahagi, ipadala ang keep_texture: true.

Kung paano hahatiin sa mga bahagi ang modelo.

Mga available na value:

• auto: Pipiliin ng Meshy ang mga hiwa at hindi papansinin ang prompt. Ang prompt na higit sa 600 character ay magbabalik pa rin ng 400.
• by_parts: Hahatiin ng Meshy ayon sa mga structural na bahaging binanggit mo sa prompt, halimbawa ulo, braso, at torso.
• by_color: Hahatiin ng Meshy ayon sa mga kulay na rehiyong binanggit mo sa prompt. Hahanapin ng Meshy ang mga rehiyon sa source image, hindi sa texture ng input na modelo. Dapat nagawa ang input mula sa na-upload na imahe, gamit ang Image to 3D o Multi-Image to 3D. Ang ibang mga input ay nagbabalik ng 400. Para sa Multi-Image to 3D, ginagamit ng Meshy ang unang source image.

Ang mga file format na gagawin. Palaging gumagawa ang Meshy ng glb at ibinabalik ito sa model_urls, kasama ang ibang mga format na nakalista mo.

Mga available na value:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Bawat format maliban sa stl ay sumusuporta sa mga scene object at nagtataglay ng bawat bahagi bilang hiwalay na object. Hindi kayang maghawak ng hiwalay na mga object ang STL file, kaya pinagsasama ng Meshy ang mga bahagi sa isang solido, na inayos ayon sa layout. Para makakuha ng mga bahaging maaari mong piliin nang hiwalay sa slicer, humiling ng 3mf.

Kapag keep_texture: true, ang mga sumusunod na format ay may taglay na texture:

• glb, fbx, usdz, at blend: Nasa file ang texture.
• obj: Nasa material file ang texture, na ibinabalik ng model_urls sa ilalim ng mtl.
• stl at 3mf: Ang file ay may taglay na heometriya lamang, walang texture.

Kung paano iaayos ng Meshy ang mga bahagi, sa bawat file format at sa thumbnail.

Mga available na value:

• assembled: Pinapanatili ng Meshy ang mga bahagi sa kinalalagyan nila sa source model.
• on_plate: Inilalatag ng Meshy ang mga bahagi nang patag at ikinakalat ang mga ito sa build plate, handa nang i-slice. Ito rin ang parehong pag-aayos ng On Plate view sa web app.

Sa parehong layout, inaalis ng Meshy ang anumang bumagsak na manipis na piraso o parang-tuldok na piraso na naiwan ng hiwa bago mag-export, kaya maaaring i-print ang bawat bahaging makukuha mo. Ang mga format na sumusuporta sa scene object ay may isang object bawat bahagi, at pinagsasama ng stl ang mga bahagi sa isang solido.

Kung pananatilihin ang texture ng input na modelo sa mga bahagi. Ang true ay nagbibigay sa bawat bahagi ng texture ng input, at ibinabalik ng task ang mga mapa sa texture_urls. Ang false ay nagbibigay sa bawat bahagi ng flat na kulay ng vertex.

Sa true, mga dalawang beses na mas matagal ang task, at hindi nagbabago ang halaga ng credit. Ang input na walang texture ay hinahati sa parehong paraan tulad ng sa false. Kung hindi mapanatili ng Meshy ang texture, mabibigo ang task na may error code na textured_split_refused. Tingnan ang Errors.

Kung magdaragdag ng mortise-and-tenon na mga connector sa bawat hiwa, para magkasya ang mga naka-print na bahagi.

Hindi matatakbo ang request. Sinasabi ng error message kung aling problema ang nahanap nito. Halimbawa:

• Missing prompt: by_parts o by_color ang mode, at wala ang prompt.
• Prompt describes no split, or too many parts: Hinihiling ng prompt na panatilihing isang piraso ang modelo, o nagbibigay ng pangalan sa higit sa 10 bahagi. Tumatanggap ang by_parts at by_color ng 1 hanggang 10 pinangalanang bahagi. Hindi sisingilin ng Meshy ang request.
• Unsupported input task: Hindi input_task_id ay isang matagumpay na task ng suportadong uri, na nagawa gamit ang Meshy 6 o Meshy 7.
• No reference image: by_color ang mode, at hindi nagawa ang input mula sa na-upload na imahe.
• Out-of-range connector: Nasa labas ng 0.1 hanggang 0.8 ang connector_size o connector_height.

Ayusin ang request, pagkatapos ay ipadala muli. Tingnan ang Errors.

Nawawala o invalid ang API key. Suriin ang Authorization header.

Halimbawa:

• Insufficient credits: Walang sapat na credits ang account para sa task na ito, o naabot na ng account ang limitasyon ng credit. Suriin ang iyong balanse ng credit, pagkatapos ay subukang muli.
• Free plan: Nangangailangan ng bayad na plano ang paggawa ng task. I-upgrade ang iyong plano sa iyong mga setting ng subscription, pagkatapos ay subukang muli.

Isa sa mga sumusunod ang naaangkop:

• Hinarang ng content moderation ang prompt. Ang mensahe ay explicit content o prohibited content. Baguhin ang prompt, pagkatapos ay subukang muli.
• Isang bas-relief na modelo ang input_task_id, na hindi mahahati ng endpoint na ito. Ang mensahe ay This model type does not support this operation. Magpadala ng ibang modelo.

Hindi umiiral ang input_task_id o hindi ito pagmamay-ari ng iyong account. Suriin ang ID, at gumamit ng API key mula sa account na gumawa ng task.

Nalagpasan mo ang iyong rate limit. Maghintay, pagkatapos ay subukang muli. Tingnan ang Rate limits.

Ang mga request na by_parts at by_color ay nagbabahagi rin ng limitasyon sa pagbabasa ng prompt na 12 request bawat minuto bawat account.

Pansamantalang hindi available ang paghahati ayon sa prompt (by_parts at by_color). Subukang muli mamaya, o magpadala ng mode: "auto", na gumagana pa rin. Hindi sisingilin ng Meshy ang request.

Ang task ID mula sa create response.

Ang ID ng task na ide-delete.

Ang numero ng pahinang ibabalik. Nagsisimula at nagde-default sa 1.

Ang bilang ng mga task kada pahina, hanggang 100. Nagde-default sa 10. Itinuturing ng Meshy ang mas malaking value bilang 100.

Ang pagkakaayos ng pag-sort.

Mga available na value:

• +created_at: pinakaluma muna
• -created_at: pinakabago muna

Ang task ID mula sa create response.

Ang task ID. Ituring ito bilang isang opaque string, at huwag umasa sa format nito.

Ang task type, palaging print-split.

Mga download URL para sa split model, isa para sa bawat format na hiniling mo. Ang format na hindi mo hiniling ay walang key. Ang mga format na sumusuporta sa scene objects ay pinapanatili ang bawat part bilang hiwalay na object, at pinagsasama-sama ng stl ang mga part sa isang solid.

Download URL para sa preview image ng split model, sa layout na hiniling mo. Kapag may texture ang mga parts, ipinapakita ito ng preview. Kung hindi, may sariling kulay ang bawat part.

Ang mga texture map ng split model, bilang isang array na may isang object. Ibinabahagi ng lahat ng parts ang mga map na ito. Naroroon lamang kapag true ang keep_texture at may texture ang input model.

Download URL para sa isang bersyon ng thumbnail_url na may transparent na background (RGBA). Naroroon lamang matapos magtagumpay ang task, kapag na-render ni Meshy ang transparent na preview.

Kung binalewala ni Meshy ang prompt. Ito ay true kapag ang prompt ng isang by_parts o by_color request ay walang pinangalanang parts, kaya awtomatikong hinati ni Meshy ang model sa halip. Ang mga pangalan ng parts sa resulta ay sa gayon ay kay Meshy, hindi sa iyo. Naroroon mula sa PENDING pataas. Tinatanggal ito ni Meshy para sa mga auto task at sa tuwing sinunod nito ang prompt.

Ang bilang ng mga naipi-print na parts na nabuo ng split. Ang mga format na sumusuporta sa scene objects ay naglalaman ng isang object bawat part. Pinagsasama ng stl ang mga parts sa isang solid, pero binibilang pa rin ito ng part_count. Bago mag-export, inaalis ni Meshy ang mga nakollaps na sliver na hindi maaaring maging naipi-print na part, at hindi ito binibilang.

Kung gaano karaming bahagi ng task ang nagawa na, bilang isang porsyento. Ito ay 0 hanggang magsimula ang task at 100 kapag ito ay matagumpay.

Ang status ng task, isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, o CANCELED.

Ang bilang ng mga task na nauuna sa task na ito sa queue. Makabuluhan lamang ang value habang PENDING ang task.

Oras na ginawa ang task, sa Unix milliseconds.

Oras na nagsimula ang task, sa Unix milliseconds. Ito ay 0 hanggang magsimula ang task.

Oras na natapos ang task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

Oras na mag-e-expire ang resulta ng task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

Ang mga detalye ng error kapag nabigo ang task. Tingnan ang Errors.

Kung tinanggihan ng isang safety check ang input model, nabibigo ang task kung saan ang task_error.type ay nakatakda sa invalid_input at ang task_error.code ay nakatakda sa provider_content_refused. Magpadala ng ibang model. Tingnan ang Errors.

Kapag keep_texture: true, kung hindi mapanatili ni Meshy ang texture, nabibigo ang task kung saan ang task_error.code ay nakatakda sa textured_split_refused. Tingnan ang Errors.

Ang bilang ng mga credit na ginamit ng task. Palagi itong naroroon. Ito ay 10 matapos tanggapin ni Meshy ang task, at 0 para sa isang FAILED na task, dahil ibinabalik ni Meshy ang mga credit kapag nabigo ang isang task. Ang pagtanggal ng isang PENDING na task ay nagbabalik din nito.