Rate Limits

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

Bakit May mga Limitasyon

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

  • Upang panatilihing ligtas at matatag ang aming serbisyo! Isipin ang mga rate limit bilang magiliw na bouncer - tinitiyak nila na walang sinuman ang makakapagpadala ng sobrang daming request sa aming API nang sabay-sabay. Nakakatulong ito na protektahan ang aming serbisyo mula sa posibleng maling paggamit at panatilihing maayos ang lahat.

  • Upang matiyak na makakakuha ang lahat ng patas na bahagi. Tulad ng pagbabahagi ng mga laruan sa palaruan, gusto naming matiyak na ang lahat ng aming mga user ay may pantay na access sa API. Sa pamamagitan ng bahagyang paglilimita sa bilang ng mga request na maaaring gawin ng bawat user, tinitiyak namin na walang sinumang maghihintay nang masyadong matagal para sa kanilang turn.

  • Upang panatilihing matulin at maaasahan ang performance. Sa pamamagitan ng pagpapamahala sa kabuuang daloy ng mga request, mapapanatili namin ang mabilis na mga oras ng tugon at matatag na serbisyo para sa lahat ng aming kahanga-hangang mga user. Parang tinitiyak na hindi masyadong siksikan ang isang highway - mas maayos ang daloy ng trapiko kapag pinipigilan natin ang congestion!

Paano Gumagana ang mga Limitasyon

Ang mga rate limit ay sinusukat 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 concurrent na generation task na maaari mong patakbuhin sa queue anumang oras.

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

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

Bukod sa rate limits, ang priority ng pagproseso ng task ay makakaapekto rin sa bilis ng iyong mga task.

Ang bawat user tier ay may partikular na mga rate limit at antas ng priority na idinisenyo 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 sa Pro
Ultra20100Pinakamataas
Studio2020Mas mataas kaysa sa Pro
Enterprise100Default sa 100, maaaring i-customizePinakamataas

Kung lampas ka sa mga limitasyong ito, makakatanggap ka ng 429 Too Many Requests na tugon mula sa aming API. May dalawang uri ng hit na maaaring mag-trigger nito, bawat isa ay may kaibang tugon:

  • Request Hit: Nangyayari ito kapag masyado kang maraming ginawang request bawat segundo. Makakatanggap ka ng 429 Too Many Requests na tugon na may mensaheng RateLimitExceeded.
  • Queue Hit: Nangyayari ito kapag masyado kang maraming tumatakbong concurrent generation task. Makakatanggap ka ng 429 Too Many Requests na tugon na may mensaheng NoMoreConcurrentTasks.