Kung ang iyong integration ay nakakaranas ng 429, RateLimitExceeded, o NoMoreConcurrentTasks na mga error kapag tumatawag sa Meshy API, ipinapaliwanag ng gabay na ito kung bakit umiiral ang mga limitasyong ito at kung paano idisenyo ang iyong integration upang gumana sa loob ng mga ito.
Bakit umiiral ang mga rate limit
Ang API ng Meshy ay nasa harap ng shared na GPU compute na ginagamit upang bumuo ng mga 3D model, texture, at kaugnay na asset. Pinoprotektahan ng mga rate limit at concurrency cap ang shared infrastructure na iyon upang manatiling pare-pareho ang kalidad ng generation at turnaround time para sa bawat user sa platform. Bawat account, batay sa kasalukuyang plan nito, ay may maximum na bilang ng request na maaaring gawin sa isang partikular na time window at maximum na bilang ng generation task na maaaring tumakbo (naka-queue o isinasagawa) nang sabay-sabay.
Request limit kumpara sa queue o concurrency limit
May dalawang magkaibang limit, at magkaiba ang paraan ng pag-fail ng mga ito:
Request rate limit (429 / RateLimitExceeded): nililimitahan nito kung gaano karaming API call (hal. paggawa ng task, status polling) ang maaari mong gawin bawat minuto. Kapag lumampas ka rito, ibig sabihin ay masyado kang madalas tumatawag sa API, anuman ang bilang ng aktwal na tumatakbong task.
Concurrency / queue limit (NoMoreConcurrentTasks): nililimitahan nito kung gaano karaming generation task ang maaari mong i-queue o iproseso nang sabay-sabay. Kapag lumampas ka rito, ibig sabihin ay naabot mo na ang maximum na bilang ng aktibong task at kailangan mong maghintay na matapos ang isa bago magsumite ng panibago.
Tingnan ang kasalukuyang request at concurrency limits ng iyong plan sa iyong Meshy dashboard, dahil maaaring mag-iba ang mga ito depende sa tier ng plan.
Estratehiya ng backoff para sa mga error 429
Kapag nakatanggap ka ng 429 o RateLimitExceeded na tugon, huwag agad na subukang muli ang parehong request. Sa halip:
Gumamit ng exponential backoff: maghintay ng maikling agwat, pagkatapos ay i-doble ito sa bawat kasunod na pagkabigo, hanggang sa isang makatwirang maximum.
Magdagdag ng jitter (isang maliit na random na offset) sa iyong backoff interval upang hindi lahat ng worker sa iyong system ay mag-retry nang sabay-sabay.
Sundin ang anumang Retry-After o rate-limit header na ibinalik sa tugon, kung mayroon, sa halip na hulaan ang oras ng paghihintay.
Limitahan ang bilang ng mga retry sa bawat request upang ang patuloy na pagkabigo ay hindi umikot nang walang katapusan.
Pagpaplano sa paligid ng mga concurrency limit
Ang error na NoMoreConcurrentTasks ay nangangahulugang naabot mo na ang pinakamataas na bilang ng aktibong task para sa iyong account. Para maiwasan itong mangyari sa production:
Panatilihin ang lokal na queue o job scheduler sa iyong sariling application na nagsusumite lamang ng bagong generation task kapag natapos na ang nauna o bumaba ang bilang ng iyong aktibong task sa ilalim ng limit.
I-poll ang status ng task (o gumamit ng webhooks, kung sinusuportahan ito sa iyong workflow) para malaman kung kailan may bakanteng slot, sa halip na magsumite nang hula-hula.
I-batch at i-throttle ang mga bulk generation job sa halip na ipadala ang lahat ng request nang sabay-sabay — nakakapagpakinis ito sa rate ng iyong request at bilang ng concurrent task.
Maglagay ng monitoring/alerting sa iyong panig para makita ang pagtaas ng 429/NoMoreConcurrentTasks error bago pa ito makaapekto sa iyong mga user.
Pagsubok muli ng mga nabigo o hindi kasiya-siyang generation
Kasalukuyang hindi sinusuportahan ng Meshy API ang built-in na "retry" ng isang umiiral na generation para sa individual o studio na plan — kung hindi natutugunan ng isang resulta ang iyong mga inaasahan, magsusumite ka ng bagong generation request, na kumokonsumo ng mga credit gaya ng dati. Kapag hinahawakan ng iyong automated na pipeline ang mga panandaliang error (tulad ng 429), tiyakin na ang iyong retry logic ay muling nagpapadala lamang ng orihinal na request pagkatapos ng backoff, at hindi gumagawa ng mga duplicate na generation task sa bawat pagkakataon.
Kailan isaalang-alang ang pag-upgrade ng iyong plan
Kung naipatupad mo na ang backoff at concurrency-aware na queuing at palagian ka pa ring tumatama sa mga rate o concurrency limit, karaniwang senyales ito na ang pangangailangan sa throughput ng iyong integration ay lumampas na sa mga limitasyon ng iyong kasalukuyang plan. Tingnan ang iyong dashboard para sa mga request at concurrency allowance ng kasalukuyang plan, at isaalang-alang ang pag-upgrade o pagkontak sa Meshy sales team tungkol sa enterprise-level na API access kung kailangan mo ng tuloy-tuloy na mas mataas na throughput.
Mga Madalas na Tanong
1. Ano ang ibig sabihin ng error na 429 o RateLimitExceeded?
Ibig sabihin nito, lumampas ka na sa bilang ng mga API request na pinapayagan sa loob ng isang takdang panahon para sa iyong plan. Bawasan ang bilis ng iyong request rate at gumamit ng exponential backoff bago subukang muli.
2. Ano ang ibig sabihin ng NoMoreConcurrentTasks?
Ibig sabihin nito, naabot mo na ang pinakamataas na bilang ng mga generation task na naka-queue o ginagawa para sa iyong account. Maghintay na matapos ang isang umiiral na task, o bawasan ang bilang ng mga task na isinusumite mo nang sabay-sabay, bago magsumite ng higit pa.
3. Paano ko malalaman ang rate at concurrency limits ng aking account?
Tingnan ang iyong Meshy dashboard para sa mga limit na nauugnay sa iyong kasalukuyang plan, dahil maaaring magkaiba ang mga ito sa bawat tier ng plan.
4. Sumusuporta ba ang Meshy ng mga automatic retry para sa mga generation task?
Hindi, hindi para sa individual o studio plan — ang nabigo o hindi kasiya-siyang generation ay dapat isumite muli bilang bagong request, na gumagamit ng credits nang normal. Dapat makipag-ugnayan ang mga enterprise customer sa sales tungkol sa functionality ng retry.
5. Ano ang pinakamahusay na paraan upang maiwasan ang mga error na ito sa isang production pipeline?
Magpatupad ng lokal na queue na naglilimita sa mga isinusumite upang manatili sa ilalim ng iyong concurrency limit, magdagdag ng exponential backoff na may jitter para sa anumang 429 response, at subaybayan ang mga error rate upang makagawa ka ng hakbang bago pa makaapekto ang mga ito sa iyong mga user.
6. Kailan dapat akong mag-upgrade dahil sa mga rate limit?
Kung naipatupad mo na ang backoff at concurrency-aware na queuing at regular ka pa ring tumatama sa mga limit na ito, malamang na nalampasan na ng iyong paggamit ang iyong kasalukuyang plan — tingnan ang iyong dashboard o makipag-ugnayan sa sales tungkol sa plan na may mas mataas na throughput.