Auto Split API

Ang ID ng isang matagumpay na task kung saan ang modelo ay ipuputol. Sinusuportahang mga uri ng task: Image to 3D, Multi-Image to 3D, Text to 3D (preview), Remesh, Convert, at Resize. Dapat ang status ng task ay SUCCEEDED, at ang modelo nito ay dapat nabuo gamit ang Meshy 6 o Meshy 7 (ai_model meshy-6, meshy-7, o latest). Hindi suportado ang mga low-poly at Smart Topology (meshy-t2) na modelo.

Paano hahatiin sa mga bahagi ang modelo.

Mga magagamit na value:

• auto: Pipiliin ni Meshy ang mga hiwa. Hindi papansinin ang prompt.
• by_parts: Hihiwain ayon sa mga structural part na pinangalanan mo sa prompt, tulad ng ulo, braso, at torso.
• by_color: Hihiwain ayon sa mga rehiyon ng kulay na pinangalanan mo sa prompt. Nangangailangan ng input na nabuo mula sa na-upload na larawan (Image to 3D o Multi-Image to 3D); tatanggihan ang ibang mga input na may 400.

Mga format kung saan i-export ang hinating modelo. Ang bawat bahagi ay hiwalay na object sa bawat format. Palaging ginagawa at ibinabalik ang glb sa model_urls; ilista ang iba pang mga format na nais mo bilang karagdagan.

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

Ang 3mf ay isinulat para sa mga slicer: isang object bawat bahagi, bawat isa sa sariling filament slot, kaya bubuksan ng Bambu Studio ang file bilang mga bahaging may sariling kulay at hiwalay na mapipili (may dalang Bambu Studio project configuration ang archive; babasahin ng ibang mga slicer ang heometriya). Tulad ng iba pang print format ng Meshy, ito ay sa millimeters at, dahil ang endpoint na ito ay walang target na laki, ang buong modelo ay isasukat upang ang pinakamahabang gilid nito ay 150 mm — ang parehong limitasyon na ginagamit ng iba pang print-format export, na pinili upang umakma sa bawat pangunahing build plate. Sa layout: "on_plate", ang limitasyon ay ikakapit sa naka-layout na plate sa kabuuan, kaya handa na ang file para i-slice; sa assembled, nananatili ang mga bahagi sa kinaroroonan nila sa source model at ikaw ang mag-aayos nito sa slicer.

Paano nakaayos ang mga bahagi sa bawat output format, at sa thumbnail.

Mga magagamit na value:

• assembled: Nananatili ang mga bahagi sa kinaroroonan nila sa source model.
• on_plate: Ang mga bahagi ay pinapatag at ikakalat sa build plate, handa na para i-slice — ang parehong pag-aayos na ginagamit ng On Plate view ng web app.

Sa parehong layout, ang mga na-export na file ay may isang object bawat bahagi at walang iba pa: ang isang naka-collapse na maliit na piraso o piraso na parang punto na natira mula sa isang paghiwa ay tatanggalin bago i-export, kaya bawat object na makikita mo sa file ay maaaring i-print.

Nagdaragdag ng mortise-and-tenon na connector sa bawat hiwa upang magkasya ang mga naka-print na bahagi.

Hindi katanggap-tanggap ang request. Karaniwang mga dahilan:

• Kulang na prompt: Kinakailangan ang prompt kung ang mode ay by_parts o by_color.
• Ang prompt ay pinangalanan ang mas kaunti sa dalawang bahagi: Ang by_parts / by_color ay nangangailangan ng hindi bababa sa dalawang pinangalanang piraso (halimbawa head, torso, base); tatanggihan ang isang generic na instruksyon tulad ng split into individual parts. Walang sisingilin.
• Hindi suportadong input task: Ang input_task_id ay dapat tumutukoy sa isang matagumpay na task ng suportadong uri, na nabuo gamit ang Meshy 6 o Meshy 7.
• May texture na input: May mga texture ang input model. Sa ngayon, suportado lamang ang mga modelong walang texture.
• Walang reference image: Ang by_color ay nangangailangan ng input na nabuo mula sa na-upload na larawan.
• Hindi suportadong format: May stl sa target_formats.
• Connector na labas sa saklaw: Ang connector_size o connector_height ay labas sa 0.1 hanggang 0.8.

Nabigo ang authentication. Pakisuri ang iyong API key.

Hindi sapat ang credits upang isagawa ang task na ito.

Ang input_task_id ay hindi umiiral o hindi kabilang sa iyong account.

Nalagpasan mo ang iyong rate limit. Ang mga request na by_parts at by_color ay nagbabahagi din ng limitasyon sa prompt-parsing na 12 request kada minuto bawat account.

Pansamantalang hindi magagamit ang prompt-based splitting (by_parts at by_color). Subukan muli mamaya, o gamitin ang mode: "auto", na hindi apektado. Walang sisingilin.

Ang ID ng Auto Split task na kukunin.

Ang ID ng Auto Split task na buburahin.

Numero ng pahina para sa pagination. Nagsisimula at nagde-default sa 1.

Limitasyon sa laki ng pahina. Ang default ay 10 na item. Ang pinakamataas na pinapayagan ay 100 na item; ang mas malalaking value ay pinipigilan sa 100.

Field na gagamitin sa pag-sort. Mga available na value:

• +created_at: Isaayos ayon sa oras ng paglikha nang pataas.
• -created_at: Isaayos ayon sa oras ng paglikha nang pababa.

Natatanging identifier para sa Auto Split task na i-stream.

Natatanging identifier para sa task. Bagama't 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 task. Ang halaga ay print-split.

Mga URL na maaaring i-download para sa hinating (split) modelo, isa para sa bawat hiniling na format. Ang bawat bahagi ay hiwalay na object sa file. Ang property para sa isang format ay hindi isasama kung hindi hiniling ang format na iyon.

Downloadable URL sa isang na-render na preview ng hinating modelo, kung saan ang bawat bahagi ay may kani-kanilang kulay, sa hiniling na layout.

true kapag ang prompt ng isang by_parts o by_color request ay walang pinangalanang bahagi, kaya awtomatikong hinati ni Meshy ang modelo — ang mga pangalan ng bahagi sa resulta ay galing kay Meshy, hindi sa iyo. Naroroon simula sa PENDING. Hindi isinasama para sa mga auto task at sa anumang pagkakataong sinunod ang prompt.

Bilang ng mga naipi-print na bahagi sa hinating modelo — isa bawat object sa mga na-export na file. Ang mga natupok na maliliit na piraso (collapsed slivers) na hindi kayang gawing naipi-print na piraso ng segmentation ay tinatanggal sa mga file bago i-export at hindi kasama sa bilang.

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

Katayuan ng task. Ang mga posibleng halaga ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Ang bilang ng mga naunang task.

Timestamp kung kailan nagawa ang task, sa millisecond.

Timestamp kung kailan nasimulan ang task, sa millisecond. Kung hindi pa nasisimulan ang task, ang property na ito ay 0.

Timestamp kung kailan natapos ang task, sa millisecond. Kung hindi pa natatapos ang task, ang property na ito ay 0.

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

Ang bilang ng mga credits na nagamit ng task na ito. Palaging naroroon: 10 sa sandaling matanggap ang task, at 0 para sa mga FAILED na task dahil naibabalik ang singil kapag nabigo. Ang pagtanggal ng isang task habang ito ay PENDING pa rin ay nagbabalik din ng bayad.