Limity rychlosti

Limity rychlosti jsou omezení, která naše API ukládá na počet přístupů uživatele nebo klienta k našim službám během stanoveného časového období.


Proč limity

Na naše API jsme zavedli limity rychlosti, abychom vytvořili co nejlepší zážitek pro všechny. Zde je důvod, proč jsou důležité:

  • Aby naše služba byla bezpečná a spolehlivá! Představte si limity rychlosti jako přátelské vyhazovače - zajišťují, že nikdo nemůže zahltit naše API příliš mnoha požadavky najednou. To pomáhá chránit naši službu před možným zneužitím a udržuje vše v plynulém chodu.

  • Aby každý dostal svůj spravedlivý podíl. Stejně jako sdílení hraček na hřišti, chceme zajistit, aby všichni naši uživatelé měli rovný přístup k API. Tím, že jemně omezujeme počet požadavků, které může každý uživatel provést, zajišťujeme, že nikdo nemusí čekat příliš dlouho na svou řadu.

  • Aby výkon zůstal svižný a spolehlivý. Řízením celkového toku požadavků můžeme udržovat rychlé doby odezvy a stabilní službu pro všechny naše úžasné uživatele. Je to jako zajistit, aby dálnice nebyla příliš přeplněná - provoz plyne lépe, když zabráníme přetížení!


Jak limity fungují

Limity rychlosti jsou měřeny dvěma způsoby:

  • Požadavky za sekundu: Toto je počet síťových požadavků, které můžete provést za sekundu.
  • Úlohy ve frontě: Toto je počet souběžných úloh generování, které můžete spustit ve frontě v daném okamžiku.

Úlohy ve frontě zahrnují Text na 3D, Obrázek na 3D, Text na texturu a Remesh endpointy. Jiné endpointy jako Upload a Balance nejsou zahrnuty v tomto limitu.

Limity jsou aplikovány na základě účtu. To znamená, že limity jsou sdíleny mezi všemi vašimi API klíči.

Kromě limitů rychlosti bude rychlost vašich úloh ovlivněna také prioritou zpracování úloh.

Každá úroveň uživatele má specifické limity rychlosti a úrovně priority navržené tak, aby odpovídaly jejich potřebám. Zde jsou aktuální limity podle úrovně:

Úroveň uživatelePožadavky za sekunduÚlohy ve frontěÚroveň priority
Pro2010Výchozí
Premium2030Vyšší než Pro
Ultra20100Nejvyšší
Studio2020Vyšší než Pro
Enterprise100Výchozí 50, lze přizpůsobitNejvyšší

Pokud tyto limity překročíte, obdržíte od našeho API odpověď 429 Too Many Requests. Existují dva typy zásahů, které to mohou spustit, každý s jinou odpovědí:

  • Zásah požadavku: K tomu dojde, když provedete příliš mnoho požadavků za sekundu. Obdržíte odpověď 429 Too Many Requests se zprávou RateLimitExceeded.
  • Zásah fronty: K tomu dojde, když máte příliš mnoho souběžných úloh generování. Obdržíte odpověď 429 Too Many Requests se zprávou NoMoreConcurrentTasks.