Ratenbegrenzungen

Prüfen Sie, wie viele Anfragen und Aufgaben Ihr Plan erlaubt, und was zu tun ist, wenn Sie ein Limit erreichen.

Limits je Plan

Damit die API für alle schnell und verfügbar bleibt, begrenzt Meshy jedes Konto auf zwei Arten:

Anfragen pro Sekunde: wie viele API-Anfragen Sie pro Sekunde senden können.
Gleichzeitige Aufgaben: wie viele Ihrer Aufgaben gleichzeitig PENDING oder IN_PROGRESS sein können.

Die Limits hängen von Ihrem Plan ab:

Plan	Anfragen pro Sekunde	Gleichzeitige Aufgaben	Priorität
Pro	20	10	Standard
Premium	20	30	Höher als Pro
Ultra	20	100	Am höchsten
Studio	20	60, oder 20 bei einigen älteren Studio-Plänen	Höher als Pro
Enterprise	100	standardmäßig 100, oder ein individuelles Limit	Am höchsten

Priorität ist kein Limit. Wenn die Warteschlange ausgelastet ist, startet Meshy zuerst die Aufgaben mit höherer Priorität.

Was auf jedes Limit angerechnet wird

Jede API-Anfrage zählt zu den Anfragen pro Sekunde, einschließlich Anfragen, die Aufgaben abrufen, auflisten oder streamen. Anfragen aus der Meshy-Web-App zählen nicht.

Das Limit für gleichzeitige Aufgaben zählt Aufgaben, nicht Anfragen. Jeder Endpunkt, der eine Aufgabe erstellt, prüft dieses Limit, bevor er eine Aufgabe erstellt. Zum Beispiel prüfen Text zu 3D, Bild zu 3D, Multi-Bild zu 3D, Neutexturierung, Neuvernetzung, Rigging, Animation, Text zu Bild, die 3D-Druck-Endpunkte und Creative Lab dieses Limit.

Anfragen, die keine Aufgabe erstellen, zählen nicht dazu. Zum Beispiel zählen Guthaben, Nutzung und Anfragen, die Aufgaben abrufen, auflisten oder streamen, nicht dazu.

Wessen Limits gelten

Die folgende Tabelle zeigt, auf wessen Limits Ihre API-Schlüssel, der Playground und die Web-App angerechnet werden:

Wo Sie arbeiten	Persönliches Konto	Team
API-Schlüssel	Ihre Limits	Die Limits des Teams, geteilt von jedem API-Schlüssel im Team
Playground	Ihre Limits	Ihre eigenen Limits als angemeldetes Mitglied
Web-App	Ihre gleichzeitigen Aufgaben	Ihre eigenen gleichzeitigen Aufgaben. Aufgaben, die der Team-Inhaber startet, zählen ebenfalls zu den Limits des Teams.

Wenn Sie ein Limit erreichen

Wenn Sie ein Limit überschreiten, gibt die API 429 Too Many Requests zurück. Die Meldung zeigt an, welches Limit Sie erreicht haben:

Zu viele Anfragen pro Sekunde: Die Meldung lautet Rate limit exceeded. Warten Sie die Anzahl der Sekunden, die im Retry-After-Header angegeben ist, und versuchen Sie es dann erneut.
Zu viele gleichzeitige Aufgaben: Die Meldung beginnt mit NoMorePendingTasks. Bei einem unbegrenzten Plan ohne verbleibende Credits beginnt sie mit NoMoreConcurrentTasks. Dieser 429-Fehler hat keinen Retry-After-Header. Warten Sie, bis eine Ihrer Aufgaben abgeschlossen ist, bevor Sie die nächste erstellen.

Rate-Limit-Header

API-Antworten enthalten diese Header, um Ihnen zu helfen, Ihre Anfragen zu takten:

Header	Beschreibung
`X-RateLimit-Limit`	Erlaubte Anfragen pro Sekunde in Ihrem Plan.
`X-RateLimit-Remaining`	Verbleibende Anfragen in der aktuellen Sekunde.
`X-RateLimit-Reset`	Sekunden, bis Ihr Kontingent wieder voll ist.
`Retry-After`	Sekunden, die Sie vor Ihrer nächsten Anfrage warten sollten. Wird mit einem `429`-Fehler bei zu vielen Anfragen pro Sekunde gesendet, sowie wenn Sie eine Aufgabe abrufen, die noch `PENDING` oder `IN_PROGRESS` ist.

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