Rate limits

Tingnan kung ilang requests at tasks ang pinapayagan ng iyong plano, at kung ano ang gagawin kapag naabot mo na ang isang limitasyon.

Mga limitasyon ayon sa plano

Upang mapanatiling mabilis at available ang API para sa lahat, nililimitahan ng Meshy ang bawat account sa dalawang paraan:

Requests per second: kung ilang API requests ang maaari mong ipadala bawat segundo.
Mga sabayang gawain (concurrent tasks): kung ilan sa iyong mga task ang maaaring PENDING o IN_PROGRESS nang sabay-sabay.

Nakadepende ang mga limitasyon sa iyong plano:

Plano	Requests per second	Mga sabayang gawain	Priority
Pro	20	10	Default
Premium	20	30	Mas mataas kaysa sa Pro
Ultra	20	100	Pinakamataas
Studio	20	60, o 20 sa ilang mas lumang planong Studio	Mas mataas kaysa sa Pro
Enterprise	100	100 bilang default, o isang custom na limitasyon	Pinakamataas

Ang priority ay hindi isang limitasyon. Kapag abala ang queue, unang sinisimulan ng Meshy ang mga task na may mas mataas na priority.

Ano ang binibilang sa bawat limitasyon

Bawat API request ay binibilang sa requests per second, kasama na ang mga request na kumukuha, naglilista, o nag-stream ng mga task. Ang mga request mula sa Meshy web app ay hindi binibilang.

Ang limitasyon sa mga sabayang gawain ay bumibilang ng mga task, hindi mga request. Bawat endpoint na lumilikha ng isang task ay sinusuri ang limitasyong ito bago gumawa ng isa. Halimbawa, sinusuri ito ng Text to 3D, Image to 3D, Multi-Image to 3D, Retexture, Remesh, Rigging, Animation, Text to Image, ang mga 3D printing endpoint, at Creative Lab.

Ang mga request na hindi lumilikha ng isang task ay hindi binibilang dito. Halimbawa, ang Balance, Usage, at mga request na kumukuha, naglilista, o nag-stream ng mga task ay hindi binibilang.

Kaninong mga limitasyon ang ipinapatupad

Ipinapakita ng sumusunod na talahanayan kung kaninong mga limitasyon ang binibilang ng iyong mga API key, ng Playground, at ng web app:

Kung saan ka nagtatrabaho	Personal na account	Team
Mga API key	Ang iyong mga limitasyon	Ang mga limitasyon ng team, na ibinabahagi ng bawat API key sa team
Playground	Ang iyong mga limitasyon	Ang sarili mong mga limitasyon bilang naka-sign-in na miyembro
Web app	Ang iyong mga sabayang gawain	Ang sarili mong mga sabayang gawain. Ang mga task na sinimulan ng may-ari ng team ay binibilang din sa mga limitasyon ng team.

Kapag naabot mo ang isang limitasyon

Kapag lumampas ka sa isang limitasyon, ibinabalik ng API ang 429 Too Many Requests. Sinasabi sa iyo ng mensahe kung aling limitasyon ang naabot mo:

Masyadong maraming requests per second: ang mensahe ay Rate limit exceeded. Hintayin ang bilang ng segundong nakasaad sa header na Retry-After, pagkatapos ay subukan ulit.
Masyadong maraming sabayang gawain: ang mensahe ay nagsisimula sa NoMorePendingTasks. Sa isang unlimited na plano na wala nang natitirang credits, ito ay nagsisimula sa NoMoreConcurrentTasks. Ang 429 na ito ay walang Retry-After header. Hintayin munang matapos ang isa sa iyong mga task bago gumawa ng susunod.

Mga header ng rate limit

Kasama sa mga sagot ng API ang mga header na ito upang matulungan kang i-pace ang iyong mga request:

Header	Paglalarawan
`X-RateLimit-Limit`	Bilang ng requests na pinapayagan bawat segundo sa iyong plano.
`X-RateLimit-Remaining`	Bilang ng requests na natitira sa kasalukuyang segundo.
`X-RateLimit-Reset`	Bilang ng segundo bago mapuno muli ang iyong budget.
`Retry-After`	Bilang ng segundong hihintayin bago ang iyong susunod na request. Ipinapadala kasama ng `429` para sa sobrang dami ng requests per second, at kapag kinuha mo ang isang task na `PENDING` o `IN_PROGRESS` pa rin.

Kapag naroroon ang Retry-After, hintayin ang nasabing bilang ng segundo bago mo ipadala ang susunod na request.