Ratenbegrenzung

Ratenbegrenzungen sind Beschränkungen, die unsere API der Anzahl der Zugriffe 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 sorgen dafür, dass niemand unsere API mit zu vielen Anfragen auf einmal überlastet. Das schützt unseren Dienst vor potenziellem Missbrauch 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 Anfrageflusses 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 voll wird – der Verkehr fließt besser, wenn wir Staus vermeiden!

---

Wie Limits funktionieren

Ratenbegrenzungen werden auf zwei 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 Generierungs-Tasks, die Sie zu jedem beliebigen 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 werden pro Konto angewendet. Das bedeutet, dass die Limits über alle Ihre API-Keys hinweg gemeinsam genutzt werden.

Neben Ratenbegrenzungen beeinflusst auch die Verarbeitungspriorität von Tasks die Geschwindigkeit Ihrer Tasks.

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

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 der Meldung Rate limit exceeded.
• Queue Hit: Dies passiert, wenn Sie zu viele gleichzeitige Generierungs-Tasks laufen haben. Sie erhalten eine 429 Too Many Requests-Antwort mit der Meldung NoMorePendingTasks (oder, wenn Ihre Credits aufgebraucht sind, NoMoreConcurrentTasks). Dieser 429-Fehler hat kein Retry-After: Warten Sie, bis einer Ihrer Tasks abgeschlossen ist, bevor Sie einen neuen erstellen.

---

Rate-Limit-Header

API-Antworten enthalten diese Header, damit Sie Ihre Anfragen entsprechend takten können:

Wenn Retry-After vorhanden ist, warten Sie diese Anzahl an Sekunden, bevor Sie die nächste Anfrage senden.