Ratenlimits und Kontingente

Aufrufe pro Minute, gleichzeitig markierte Clips, fehlgeschlagene Aufrufe pro Tag und Kontingente pro Monat, je Organisation: alle ihre Schlüssel zusammen, gemäß Ihrem Plan. Aufrufe ohne Schlüssel zählen pro Adresse.

Aufrufe pro Minute

Jeder authentifizierte Aufruf zählt zum Limit seiner Organisation, alle ihre Schlüssel zusammen: Markierungen, Zeitstempel und Nutzungsabfragen gleichermaßen. Die Zeitfenster sind volle Uhrminuten (UTC), die Zählung beginnt also mit jeder neuen Minute von vorn. Jede Antwort zeigt, wo Sie stehen:

X-RateLimit-Limit: 10          # calls this minute, for this organisation
X-RateLimit-Remaining: 7       # left this minute
X-RateLimit-Reset: 1792663260  # Unix time (s) when the minute ends

Über dem Limit antwortet die API mit 429 rate_limited und Retry-After in Sekunden. Verteilen Sie die Arbeit über die Minute, oder wechseln Sie in einen größeren Plan. Die SDKs für JavaScript und Python warten ein Retry-After von bis zu einer Minute selbst ab.

Fehlgeschlagene Aufrufe

Eine Markierung oder Prüfung, die fehlschlägt, nachdem wir daran gearbeitet haben (mark_failed oder eine Prüfung, die nicht abgeschlossen werden konnte), zählt nichts; deshalb haben diese Fehlschläge eine Tagesobergrenze pro Organisation: Free 100, Indie 300, Startup 1.000, Scale 3.000 pro Tag (UTC). Darüber antworten POST /v1/mark und POST /v1/check bis 00:00 UTC mit 429. Ablehnungen vor jeder Arbeit (eine Datei, die wir nicht lesen können, eine Blockierung, nicht genug verbleibende Markierungen) zählen nicht.

Clips

Ein Clip wird als Auftrag markiert, und jeder Plan markiert einige gleichzeitig (Free 1, Indie 2, Startup 3, Scale 5). Ein Clip, der gesendet wird, während alle laufen, erhält 429 rate_limited mit Retry-After: 30.

Ein Clip, der fehlschlägt, nachdem wir daran gearbeitet haben (sein Wasserzeichen lässt sich nicht zurücklesen, oder er kann nicht rechtzeitig markiert werden: mark_failed), zählt nichts; deshalb haben diese Fehlschläge eine Tagesobergrenze: Free 3, Indie 10, Startup 10, Scale 20 in 24 Stunden. Darüber erhalten neue Clips 429, bis der erste dieser Fehlschläge einen Tag alt ist. GET /v1/marks/{id} sagt, warum jeder fehlgeschlagen ist. Ablehnungen vor jeder Arbeit (ein Clip über unseren Limits, eine Blockierung, nicht genug verbleibende Markierungen) zählen nicht.

Aufrufe ohne Schlüssel

Die öffentlichen Endpunkte zählen stattdessen pro Adresse, mit denselben Headern. Eine IPv6-Adresse zählt nach ihrem /64, dem Block, den ein Anschluss üblicherweise erhält.

• POST /v1/verify: 10 Dateien pro Minute und 200 pro Tag. Ohne Schlüssel beantwortet der gesamte Dienst außerdem höchstens 5.000 Prüfungen pro Tag (UTC) und 500 mit signed=true; mit einem Schlüssel (kostenlos) zählen Prüfungen stattdessen zu den Aufrufen pro Minute Ihrer Organisation. Das Prüftool liest Dateien in Ihrem Browser und zählt hier nicht.
• Das Transparenzprotokoll, GET /v1/credentials und GET /v1/verify/key: 120 Aufrufe pro Minute.

Monatliche Kontingente

• Markierungen: eine pro erfolgreichem POST /v1/mark und zwei pro Bild, das die Sicherheitsprüfung liest (POST /v1/check oder check bei einer Markierung). Testschlüssel haben ein eigenes Kontingent: 100 Markierungen im Monat im Free-Plan, in kostenpflichtigen Plänen so viele wie live. Die 1.000 Markierungen des Free-Plans sind ein Kontingent pro Person: Die erste Organisation einer Person erhält sie, und jede weitere, die diese Person erstellt, beginnt ohne, bis sie einen kostenpflichtigen Plan hat.
• Zurückgesendete Daten: die Bytes der markierten Dateien, die wir im Cloud-Modus zurücksenden (1 GB = 10⁹ Byte).
• Zeitstempel: einer pro POST /v1/tsa, bis zur Zahl der Markierungen Ihres Plans, auch hier getrennt nach Live und Test.

Kontingente gelten pro Kalendermonat in UTC. Ist eines aufgebraucht, antwortet die API mit 402 quota_exceeded bis zum Ersten des Folgemonats oder bis zu einem Upgrade. Eine Markierung wird reserviert, wenn eine Anfrage angenommen wird, und zurückgegeben, wenn etwas fehlschlägt, sodass nur gelieferte Markierungen zählen. Ihre aktuellen Zahlen finden Sie im Dashboard, in den Headern X-Marks-Used und X-Marks-Limit und unter GET /v1/usage.

Monatliche kostenpflichtige Pläne laufen über ihr Kontingent hinaus zu den veröffentlichten Preisen für Zusatzmengen weiter, abgerechnet am Monatsersten, bis zum Zehnfachen des Kontingents; Jahrespläne stoppen beim Kontingent, wie der Free-Plan.