Remesh API

Kinakailangan maliban kung ipadala mo ang model_url. Ang ID ng task kung saang modelo mo gustong i-remesh, halimbawa isang Text to 3D, Image to 3D, Retexture, o Remesh task. Dapat ang task ay isang ginawa mo gamit ang API at may status na SUCCEEDED.

Kinakailangan maliban kung ipadala mo ang input_task_id. Ang modelong ire-remesh, bilang isang pampublikong URL o isang data URI. Kung parehas mong ipapadala, ginagamit ng Meshy ang input_task_id.

Dapat ang modelo ay isang GLB, glTF, OBJ, FBX, o STL file na hindi hihigit sa 400 MB mula sa isang http o https URL, o 100 MB bilang data URI. Para sa data URI, gamitin ang MIME type na application/octet-stream.

Ang file na mahigit 100 MB ay dapat ding sumunod sa mga sumusunod na patakaran:

• Ang GLB, glTF, FBX, o OBJ file ay maaaring magkaroon ng hanggang 10,000,000 faces. Binibilang ng Meshy ang faces bilang mga triangle, kaya ang isang quad ay binibilang bilang 2, at ang isang mesh na naguhit nang higit sa isang beses ay binibilang isang beses bawat kopya.
• Ang FBX file ay dapat binary FBX 7.1 o mas bago.
• Ang GLB o glTF file ay hindi dapat gumamit ng Draco compression.

Ang mga file format na gagawin.

Mga available na value:

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

Ang uri ng face ng na-remesh na modelo.

Mga available na value:

• quad: isang mesh na quad-dominant
• triangle: isang na-decimate na triangle mesh

Ang bilang ng mga face na target, mula 100 hanggang 300000. Maaaring magkaiba ang resulta sa target, depende sa heometriya ng modelo. Ang value na labas sa saklaw ay nagbabalik ng 400.

Adaptive na bilang ng face, ayon sa antas. Kapag itinakda mo ito, hindi papansinin ng Meshy ang target_polycount.

Mga available na value:

• 1: ultra
• 2: mataas
• 3: katamtaman
• 4: mababa

Gamitin ang Resize API sa halip. Ang taas na iresize ang modelo, sa metro. Magpadala ng hindi hihigit sa isa sa resize_height, resize_longest_side, at auto_size.

Gamitin ang Resize API sa halip. Ang haba na iresize ang pinakamahabang gilid ng bounding box ng modelo, sa metro. Magpadala ng hindi hihigit sa isa sa resize_height, resize_longest_side, at auto_size.

Gamitin ang Resize API sa halip. Kung tatantyahin ang tunay na taas ng bagay gamit ang AI vision at ire-resize ang modelo dito. Magpadala ng hindi hihigit sa isa sa resize_height, resize_longest_side, at auto_size.

Gamitin ang Resize API sa halip. Kung saan ilalagay ang origin ng modelo, bottom o center. Nalalapat ang default kapag ipinadala mo ang resize_height, resize_longest_side, o auto_size. Kung wala sa mga ito, ililipat lamang ng Meshy ang origin kung ipapadala mo ang origin_at.

Gamitin ang Convert API sa halip. Kung ic-convert lamang ang modelo sa target_formats. Kapag true, hindi papansinin ng Meshy ang topology, target_polycount, decimation_mode, resize_height, resize_longest_side, at auto_size, pero susuriin pa rin ang kanilang mga value, kaya ang di-balidong value ay nagbabalik ng 400. Sa convert_format_only: true, ang walang laman o null na target_formats ay nagbabalik ng 400.

Kung magre-render din ng preview na may transparent na background (RGBA), ibinabalik sa alpha_thumbnail_url kapag kinuha mo ang task. Hindi nagbabago ang thumbnail_url.

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

• Nawawalang parameter: Hindi ipinadala ang alinman sa model_url o input_task_id.
• Di-balidong input task: Ang input_task_id ay hindi isang matagumpay na API task, o hindi sinusuportahan ng AI model nito ang remeshing.
• Di-balidong format ng modelo: Ang model_url file ay may hindi suportadong extension.
• Hindi maabot na URL: Hindi ma-download ng Meshy ang model_url file.
• Masyadong malaki ang model file: Ang model_url file ay mahigit 400 MB mula sa isang http o https URL, o mahigit 100 MB bilang data URI.
• Sobra-sobra ang faces: Ang model_url file ay mahigit 100 MB at may higit sa 10,000,000 faces. Bawasan ang bilang ng faces, pagkatapos ipadala muli ang file.
• ASCII FBX na mahigit 100 MB: Ang model_url file ay isang ASCII FBX na mahigit 100 MB. Ipadala ito bilang binary FBX o GLB.
• Hindi mabasang model file: Ang model_url file ay mahigit 100 MB, at hindi mabasa ng Meshy ang header nito. Halimbawa, ito ay isang Draco-compressed GLB o glTF, o isang binary FBX na mas luma sa 7.1.
• Masyadong kumplikado ang model header: Ang model_url file ay mahigit 100 MB, at ang header nito ay may masyadong maraming mesh, node, o record na susuriin. Bawasan ang bilang ng mga bagay sa file, pagkatapos ipadala muli ito.
• Di-balidong topology: Ang topology ay hindi quad o triangle.
• Magkasalungat na parameter: Ang request ay may higit sa isa sa auto_size, resize_height, at resize_longest_side. Magpadala lamang ng isa.

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

Nawawala o di-balido ang API key. Suriin ang Authorization header.

Halimbawa:

• Hindi sapat na credits: Ang account ay walang sapat na credits para sa task na ito, o naabot ng account ang limitasyon ng credit. Suriin ang iyong balanse ng credit, pagkatapos subukan muli.
• Libreng plano: Ang paggawa ng task ay nangangailangan ng bayad na plano. I-upgrade ang iyong plano sa iyong mga setting ng subscription, pagkatapos subukan muli.

Ang input_task_id ay isang bas-relief na modelo, na hindi kayang i-remesh ng endpoint na ito. Ang mensahe ay This model type does not support this operation. Magpadala ng ibang modelo.

Ang input_task_id ay hindi tumugma sa alinman sa iyong mga task. Suriin ang ID ng task, pagkatapos ipadala muli ang request.

Nalampasan mo ang iyong rate limit. Maghintay, pagkatapos subukan muli. Tingnan ang Rate limits.

Ang task ID mula sa create response.

Ang ID ng task na ide-delete.

Ang numero ng pahina na ibabalik, hanggang 255. Ang mas malaking value ay magbabalik ng 400.

Ang bilang ng mga task kada pahina, hanggang 100.

Ang pagkakaayos ng pagsasaayos.

Mga available na value:

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

Ang task ID mula sa response ng paglikha (create).

Ang task ID. Ituring itong isang opaque na string, at huwag umasa sa format nito.

Ang uri ng task, palaging remesh.

Mga download URL para sa remeshed na model, isa para sa bawat file format. Ang format na hindi na-generate ng task ay walang key, sa halip na isang blankong string.

Download URL para sa preview image ng remeshed na model.

Download URL para sa bersyon ng thumbnail_url na may transparent na background (RGBA). Naroroon lamang kapag ginawa mo ang task gamit ang alpha_thumbnail: true at na-render ng Meshy ang transparent na preview.

Kung gaano karami ang natapos sa task, bilang isang porsyento. Ito ay 0 hanggang magsimula ang task at 100 kapag ito ay nagtagumpay.

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

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

Oras kung kailan ginawa ang task, sa Unix milliseconds.

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

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

Oras kung kailan mag-e-expire ang mga download URL ng task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

Mga download URL para sa texture maps ng model, kapag nagtagumpay ang task: isang array ng mga object, isa para sa bawat texture set. Bawat object ay may base_color URL, at maaari ring magkaroon ng metallic, roughness, normal, emission, at metallic_roughness na mga URL. Ito ay null hanggang magtagumpay ang task, at isang blankong array kapag ang model ay walang texture maps.

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

Ang bilang ng credits na ginamit ng task. Naroroon kapag ang status ay PENDING, IN_PROGRESS, o SUCCEEDED. Ito ay 0 para sa isang FAILED na task, dahil ire-refund ng Meshy ang credits kapag nabigo ang isang task.