Rigging API

Kinakailangan maliban kung magpapadala ka ng model_url. Ang ID ng task na ang model ay gusto mong i-rig. Sinusuportahan ng Meshy ang mga may-texture na humanoid na model.

Ang model ay maaaring magkaroon ng pinakamarami na 380,000 triangles (ang quad ay binibilang bilang 2), at kung lumagpas dito ay magbabalik ng 400. Para manatili sa ilalim ng limitasyon, patakbuhin muna ang Remesh API dito gamit ang target_polycount na 300000 o mas mababa, o 150000 o mas mababa kung topology: quad.

Kinakailangan maliban kung magpapadala ka ng input_task_id. Ang model na i-rig, bilang isang pampublikong URL o isang data URI. Kung magpapadala ka ng pareho, gagamitin ng Meshy ang input_task_id.

Ang model ay dapat na isang GLB (.glb) file na hindi hihigit sa 400 MB mula sa isang http o https URL, o 100 MB bilang isang data URI. Sinusuportahan ng Rigging ang mga may-texture na humanoid na model.

Ang model ay maaaring magkaroon ng pinakamarami na 380,000 triangles (ang quad ay binibilang bilang 2), at kung lumagpas dito ay magbabalik ng 400. Para manatili sa ilalim ng limitasyon, patakbuhin muna ang Remesh API dito gamit ang target_polycount na 300000 o mas mababa, o 150000 o mas mababa kung topology: quad.

Ang mukha ng character ay dapat nakaharap sa +Z axis, ang standard na glTF forward direction. Mabibigo ang pose estimation para sa isang model na nakaharap sa ibang axis.

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

• Maaari itong magkaroon ng pinakamarami na 10,000,000 faces. Kung lumagpas dito ay magbabalik ng 400. Binibilang ng Meshy ang faces bilang triangles, at ang isang mesh na naguguhit nang higit sa isang beses ay binibilang isang beses kada kopya.
• Hindi ito dapat gumamit ng Draco compression.

Ang tinatayang taas ng character, sa metro. Ginagamit ito ng Meshy para mas tumpak na i-scale at i-rig ang model. Ang negatibong halaga ay magbabalik ng 400.

Huwag isama kung ang model ay mayroon nang sariling texture. Kapag wala ito, gagamitin ng Meshy ang mga texture na naka-embed sa model_url file, o ang mga texture ng input task. Kung ipapadala mo ito, ang imaheng ito ang magiging tanging texture ng naka-rig na model, at mawawala sa model ang mga PBR maps nito.

Ang UV-unwrapped na base color texture ng model, bilang isang pampublikong URL o isang data URI. Ang imahe ay dapat na isang PNG file na hindi hihigit sa 20 MB. Ang ibang format ng imahe ay magbabalik ng 400.

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

• Nawawalang parameter: Hindi ipinadala ang model_url o input_task_id.
• Di-wastong format ng model: Ang model_url file ay may hindi suportadong extension. Tanging .glb lamang ang suportado.
• Hindi maabot na URL: Hindi ma-download ng Meshy ang model_url file.
• Masyadong malaki ang model file: Ang model_url file ay lumalagpas sa 400 MB mula sa isang http o https URL, o lumalagpas sa 100 MB bilang isang data URI.
• Sobra sa limitasyon ang faces: Ang model_url file ay lumalagpas sa 100 MB at may higit sa 10,000,000 faces. Bawasan ang bilang ng faces, pagkatapos ay ipadala muli ang file.
• Hindi mabasang model file: Ang model_url file ay lumalagpas sa 100 MB, at hindi mabasa ng Meshy ang header nito. Halimbawa, ito ay isang Draco-compressed GLB.
• Masyadong kumplikado ang header ng model: Ang model_url file ay lumalagpas sa 100 MB, at ang header nito ay may masyadong maraming mesh, node, o record na susuriin. Bawasan ang bilang ng mga object sa file, pagkatapos ay ipadala itong muli.
• Masyadong malaki ang imahe: Ang texture_image_url na imahe ay lumalagpas sa 20 MB.
• Di-wastong format ng texture: Ang texture_image_url na imahe ay hindi isang PNG file.
• Di-wastong taas: Negatibo ang height_meters.
• Di-wastong input task: Hindi tumutukoy ang input_task_id sa isang wastong API task.
• Hindi pa handa ang input task: Hindi pa nakarating sa SUCCEEDED ang input_task_id task. Maghintay hanggang magtagumpay ito, pagkatapos ay subukan muli.
• Lumagpas sa limitasyon ang bilang ng faces: Ang input model ay may higit sa 380,000 triangles (ang quad ay binibilang bilang 2). Patakbuhin ang Remesh API dito gamit ang target_polycount na 300000 o mas mababa, o 150000 o mas mababa kung topology: quad, bago i-rig ang model.

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

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

Halimbawa:

• Hindi sapat na credits: Wala sapat na credits ang account para sa task na ito, o naabot ng account ang limitasyon ng credit. Suriin ang iyong balanse ng credit, pagkatapos ay 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 ay subukan muli.

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

Hindi mahanap ng Meshy ang mga file ng input_task_id task. Isa sa mga sumusunod ang nangyayari:

• Binura ng Meshy ang mga file ng task matapos ang expires_at nito. Gawin muli ang task, pagkatapos ay ipadala ang ID ng task na iyon.
• Wala sa task ang mga file na kailangan ng rigging, tulad ng preview image, halimbawa isang Convert task. I-rig ang task na pinagmulan nito, o ipadala ang model bilang model_url.

Nabigo ang pose estimation. Maaaring hindi ang model ay isang wastong humanoid character. Magpadala ng model ng isang humanoid character. Para sa model_url, suriin din na ang character ay nakaharap sa +Z axis.

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

Ang task ID mula sa create response.

Ang ID ng task na ide-delete.

Ang task ID mula sa create response.

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

Ang uri ng task, laging rig.

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

Kung gaano na katapos ang task, bilang isang porsyento. 0 ito hanggang magsimula ang task at 100 kapag nagtagumpay ito.

Oras nang ginawa ang task, sa Unix milliseconds.

Oras nang nagsimula ang task, sa Unix milliseconds. 0 ito hanggang magsimula ang task.

Oras nang natapos ang task, sa Unix milliseconds. 0 ito hanggang matapos ang task.

Oras kung kailan mag-e-expire ang mga result file ng task, sa Unix milliseconds. Pagkatapos ng oras na ito, maaaring tanggalin ng Meshy ang mga file.

Ang detalye ng error kapag nabigo ang task. null ito maliban kung FAILED ang status. Tingnan ang Errors.

Ang bilang ng credits na ginamit ng task. Nakalagay ito kapag ang status ay PENDING, IN_PROGRESS, o SUCCEEDED. 0 ito para sa isang FAILED na task, dahil ibinabalik ng Meshy ang credits kapag nabigo ang isang task.

Ang mga URL ng output file. Hanggang magtagumpay ang task, bawat URL ay isang blangkong string, at null ang basic_animations.

Ang bilang ng mga task na nauuna sa queue bago ang task na ito. Makabuluhan lamang ang value habang PENDING ang task. Hindi isinasama ang field na ito kapag 0 ang value.