Mga Limitasyon sa Rate

Ang mga limitasyon sa rate ay mga restriksyon na ipinapataw ng aming API sa bilang ng beses na maaaring ma-access ng isang user o kliyente ang aming mga serbisyo sa loob ng isang tinukoy na panahon.

Bakit May Mga Limitasyon

Naglagay kami ng mga limitasyon sa rate sa aming API upang makatulong na lumikha ng pinakamahusay na karanasan para sa lahat. Narito kung bakit sila mahalaga:

  • Upang mapanatiling ligtas at maayos ang aming serbisyo! Isipin ang mga limitasyon sa rate bilang mga mabait na bouncer - tinitiyak nila na walang sinuman ang makakabugbog sa aming API ng sobrang daming kahilingan nang sabay-sabay. Nakakatulong ito na protektahan ang aming serbisyo mula sa potensyal na maling paggamit at pinapanatili ang lahat ng bagay na maayos.

  • Upang matiyak na lahat ay makakakuha ng patas na bahagi. Tulad ng pagbabahagi ng mga laruan sa palaruan, nais naming tiyakin na lahat ng aming mga user ay may pantay na access sa API. Sa pamamagitan ng banayad na paglilimita kung gaano karaming kahilingan ang maaaring gawin ng bawat user, tinitiyak namin na walang sinuman ang kailangang maghintay ng masyadong matagal para sa kanilang pagkakataon.

  • Upang mapanatiling mabilis at maaasahan ang pagganap. Sa pamamagitan ng pamamahala sa kabuuang daloy ng mga kahilingan, maaari naming mapanatili ang mabilis na oras ng pagtugon at matatag na serbisyo para sa lahat ng aming magagandang user. Parang tinitiyak na ang isang highway ay hindi masyadong masikip - mas maayos ang daloy ng trapiko kapag pinipigilan natin ang pagsisikip!

Paano Gumagana ang Mga Limitasyon

Ang mga limitasyon sa rate ay sinusukat sa 2 paraan:

  • Requests per Second: Ito ang bilang ng mga network request na maaari mong gawin kada segundo.
  • Queue Tasks: Ito ang bilang ng mga sabay-sabay na generation tasks na maaari mong patakbuhin sa pila sa anumang oras.

Kasama sa queue tasks ang Text to 3D, Image to 3D, Text to Texture, at Remesh endpoints. Ang ibang endpoints tulad ng Upload at Balance ay hindi kasama sa limitasyong ito.

Ang mga limitasyon ay ipinapataw sa bawat account. Ibig sabihin, ang mga limitasyon ay ibinabahagi sa lahat ng iyong API keys.

Bukod sa mga limitasyon sa rate, ang prayoridad sa pagproseso ng task ay makakaapekto rin sa bilis ng iyong mga task.

Ang bawat user tier ay may partikular na mga limitasyon sa rate at antas ng prayoridad na idinisenyo upang tumugma sa kanilang mga pangangailangan. Narito ang kasalukuyang mga limitasyon ayon sa tier:

User TierRequests per SecondQueue TasksPriority Level
Pro2010Default
Premium2030Mas Mataas kaysa Pro
Ultra20100Pinakamataas
Studio2020Mas Mataas kaysa Pro
Enterprise100Default sa 50, maaaring i-customizePinakamataas

Kung lalampas ka sa mga limitasyong ito, makakatanggap ka ng 429 Too Many Requests na tugon mula sa aming API. Mayroong dalawang uri ng hits na maaaring mag-trigger nito, bawat isa ay may ibang tugon:

  • Request Hit: Nangyayari ito kapag gumawa ka ng sobrang daming kahilingan kada segundo. Makakatanggap ka ng 429 Too Many Requests na tugon na may mensaheng RateLimitExceeded.
  • Queue Hit: Nangyayari ito kapag mayroon kang sobrang daming sabay-sabay na generation tasks na tumatakbo. Makakatanggap ka ng 429 Too Many Requests na tugon na may mensaheng NoMoreConcurrentTasks.