Rate Limits

Rate Limits sind Einschränkungen, die unsere API für die Anzahl der Zugriffe eines Benutzers oder Clients auf unsere Dienste innerhalb eines bestimmten Zeitraums festlegt.

Warum Limits

Wir haben Rate Limits für unsere API eingeführt, um allen das bestmögliche Erlebnis zu bieten. Deshalb sind sie wichtig:

  • Damit unser Dienst sicher und stabil bleibt! Stell dir Rate Limits wie freundliche Türsteher vor – sie stellen sicher, dass niemand unsere API mit zu vielen Anfragen auf einmal überlastet. Das schützt unseren Dienst vor möglichem Missbrauch und sorgt dafür, dass alles reibungslos läuft.

  • Damit alle ihren fairen Anteil bekommen. Genau wie beim Teilen von Spielzeug auf einem Spielplatz möchten wir sicherstellen, dass alle unsere Nutzer gleichberechtigten Zugriff auf die API haben. Indem wir die Anzahl der Anfragen, die jeder Nutzer stellen kann, behutsam begrenzen, stellen wir sicher, dass niemand zu lange warten muss, bis er an der Reihe ist.

  • Damit die Leistung schnell und zuverlässig bleibt. Indem wir den gesamten Anfragefluss steuern, können wir schnelle Antwortzeiten und einen stabilen Dienst für all unsere großartigen Nutzer aufrechterhalten. Es ist wie bei einer Autobahn: Wenn sie nicht zu voll wird, fließt der Verkehr besser – Staus vermeiden hilft!

Wie Limits funktionieren

Rate Limits werden auf 2 Arten gemessen:

  • Requests per Second: Dies ist die Anzahl der Netzwerkanfragen, die du pro Sekunde stellen kannst.
  • Queue Tasks: Dies ist die Anzahl gleichzeitiger Generierungsaufgaben, die du zu einem beliebigen Zeitpunkt in der Warteschlange ausführen kannst.

Queue Tasks umfassen die Endpoints Text to 3D, Image to 3D, Text to Texture und Remesh. Andere Endpoints wie Upload und Balance sind in diesem Limit nicht enthalten.

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

Neben Rate Limits beeinflusst auch die Priorität der Aufgabenverarbeitung die Geschwindigkeit deiner Aufgaben.

Jede Nutzerstufe hat spezifische Rate Limits und Prioritätsstufen, die auf ihre Anforderungen abgestimmt sind. Hier sind die aktuellen Limits nach Stufe:

User TierRequests per SecondQueue TasksPriority Level
Pro2010Standard
Studio2020Höher als Pro
Enterprise100Standardmäßig 50, kann angepasst werdenHöchste

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

  • Request Hit: Dies passiert, wenn du zu viele Anfragen pro Sekunde stellst. Du erhältst eine 429 Too Many Requests-Antwort mit einer RateLimitExceeded-Nachricht.
  • Queue Hit: Dies passiert, wenn zu viele gleichzeitige Generierungsaufgaben laufen. Du erhältst eine 429 Too Many Requests-Antwort mit einer NoMoreConcurrentTasks-Nachricht.