Mga Rate Limit

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

Bakit May Mga Limitasyon

Naglagay kami ng mga rate limit sa aming API upang makatulong na makalikha ng pinakamagandang karanasan para sa lahat. Narito kung bakit mahalaga ang mga ito:

  • Upang mapanatiling ligtas at maayos ang aming serbisyo! Isipin ang mga rate limit bilang magigiliw na bouncer - tinitiyak nilang walang makakapag-overwhelm sa aming API sa sobrang daming request nang sabay-sabay. Nakakatulong ito na protektahan ang aming serbisyo mula sa posibleng maling paggamit at pinapanatiling maayos ang takbo ng lahat.

  • Upang matiyak na lahat ay nakakakuha ng kanilang patas na bahagi. Tulad ng pagbabahagi ng mga laruan sa palaruan, gusto naming tiyaking lahat ng aming user ay may pantay na access sa API. Sa pamamagitan ng banayad na paglilimita kung gaano karaming request ang maaaring gawin ng bawat user, tinitiyak naming walang kailangang maghintay nang masyadong matagal para sa kanilang turno.

  • Upang mapanatiling mabilis at maaasahan ang performance. Sa pamamagitan ng pamamahala sa kabuuang daloy ng mga request, napapanatili namin ang mabilis na response time at matatag na serbisyo para sa lahat ng aming kahanga-hangang user. Para itong pagtiyak na hindi masyadong napupuno ang isang highway - mas maayos ang daloy ng trapiko kapag pinipigilan natin ang congestion!

Paano Gumagana ang mga Limitasyon

Sinusukat ang mga rate limit sa 2 paraan:

  • requests per second: Ito ang bilang ng mga network request na maaari mong gawin bawat segundo.
  • queue tasks: Ito ang bilang ng mga sabay-sabay na generation task na maaari mong patakbuhin sa queue sa anumang oras.

Kabilang sa queue tasks ang Text to 3D, Image to 3D, Text to Texture, at mga Remesh endpoint. Ang iba pang mga endpoint tulad ng Upload at balanse ay hindi kasama sa limitasyong ito.

Inilalapat ang mga limitasyon batay sa bawat account. Ibig sabihin, ang mga limitasyon ay ibinabahagi sa lahat ng iyong API key.

Bukod sa mga rate limit, makakaapekto rin ang task processing priority sa bilis ng iyong mga task.

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

user tierrequests per secondqueue tasksAntas ng Priority
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 response mula sa aming API. May dalawang uri ng hit na maaaring mag-trigger nito, bawat isa ay may ibang response:

  • Request Hit: Nangyayari ito kapag gumawa ka ng masyadong maraming request bawat segundo. Makakatanggap ka ng 429 Too Many Requests response na may mensaheng RateLimitExceeded.
  • Queue Hit: Nangyayari ito kapag mayroon kang masyadong maraming sabay-sabay na generation task na tumatakbo. Makakatanggap ka ng 429 Too Many Requests response na may mensaheng NoMoreConcurrentTasks.