Ratenbegrenzungen

Ratenbegrenzungen sind Einschränkungen, die unsere API der Anzahl an Zugriffen auferlegt, die ein Nutzer oder Client innerhalb eines bestimmten Zeitraums auf unsere Dienste vornehmen kann.

Warum Limits

Wir haben Ratenbegrenzungen für unsere API eingeführt, um für alle die bestmögliche Erfahrung zu schaffen. Hier ist, warum sie wichtig sind:

Um unseren Dienst sicher und stabil zu halten! Stellen Sie sich Ratenbegrenzungen wie freundliche Türsteher vor - sie stellen sicher, dass niemand unsere API mit zu vielen Anfragen auf einmal überlastet. Das hilft, unseren Dienst vor möglichem Missbrauch zu schützen und sorgt dafür, dass alles reibungslos läuft.
Um sicherzustellen, dass jeder seinen fairen Anteil bekommt. Genau wie beim Teilen von Spielzeug auf einem Spielplatz möchten wir sicherstellen, dass alle unsere Nutzer gleichberechtigten Zugang zur API haben. Indem wir sanft begrenzen, wie viele Anfragen jeder Nutzer stellen kann, stellen wir sicher, dass niemand zu lange auf seine Chance warten muss.
Um die Leistung flott und zuverlässig zu halten. Durch die Steuerung des gesamten Anfragenflusses können wir schnelle Antwortzeiten und einen stabilen Dienst für alle unsere großartigen Nutzer aufrechterhalten. Es ist so, als würde man dafür sorgen, dass eine Autobahn nicht zu überfüllt wird - der Verkehr fließt besser, wenn wir Staus vermeiden!

Wie Limits funktionieren

Ratenbegrenzungen werden auf 2 Arten gemessen:

Anfragen pro Sekunde: Dies ist die Anzahl der Netzwerkanfragen, die Sie pro Sekunde stellen können.
Warteschlangen-Tasks: Dies ist die Anzahl der gleichzeitigen Generierungsaufgaben, die Sie zu einem bestimmten Zeitpunkt in der Warteschlange ausführen können.

Warteschlangen-Tasks umfassen die Endpunkte Text zu 3D, Bild zu 3D, Text zu Textur und Neuvernetzung. Andere Endpunkte wie Upload und Balance sind in diesem Limit nicht enthalten.

Die Limits gelten pro Konto. Das bedeutet, dass die Limits über alle Ihre API keys hinweg geteilt werden.

Neben den Ratenbegrenzungen wirkt sich auch die Priorität der Aufgabenverarbeitung auf die Geschwindigkeit Ihrer Tasks aus.

Jede Nutzerstufe hat spezifische Ratenbegrenzungen und Prioritätsstufen, die auf ihre jeweiligen Bedürfnisse zugeschnitten sind. Hier sind die aktuellen Limits nach Stufe:

Nutzerstufe	Anfragen pro Sekunde	Warteschlangen-Tasks	Prioritätsstufe
Pro	20	10	Standard
Premium	20	30	Höher als Pro
Ultra	20	100	Am höchsten
Studio	20	20	Höher als Pro
Enterprise	100	Standardmäßig 100, kann angepasst werden	Am höchsten

Wenn Sie diese Limits überschreiten, erhalten Sie von unserer API eine 429 Too Many Requests-Antwort. Es gibt zwei Arten von Treffern, die dies auslösen können, jeweils mit einer anderen Antwort:

Request Hit: Dies passiert, wenn Sie zu viele Anfragen pro Sekunde stellen. Sie erhalten eine 429 Too Many Requests-Antwort mit einer RateLimitExceeded-Meldung.
Queue Hit: Dies passiert, wenn Sie zu viele gleichzeitige Generierungsaufgaben laufen haben. Sie erhalten eine 429 Too Many Requests-Antwort mit einer NoMoreConcurrentTasks-Meldung.