Grenzen

Es gelten Limits pro Konto. Alle Schlüssel eines Kontos teilen sie.

Tarifbegrenzungen

Endpunkt	Pro Minute	Pro Stunde	Pro Tag
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Jedes Rendering zählt außerdem zum Gesamtrenderlimit des Kontos von 5 pro Minute, 60 pro Stunde und 300 pro Tag. Dieses Limit wird mit Renderings geteilt, die in der App gestartet werden, sodass ein beschäftigtes Team in der App weniger Platz für die APIlässt.

Anfragen werden in festen Fenstern von einer Minute, einer Stunde und einem Tag gezählt. Wenn Sie übergehen, erhalten Sie 429 mit code: "RATE_LIMITED" und der Anzahl der Sekunden zum Warten, in retryAfter oder details.retryAfter:

{ "error": "Rate limit exceeded", "retryAfter": 37, "code": "RATE_LIMITED" }

GET /v1/me und GET /v1/job/{id} haben heute kein Rate-Limit. Frage alle paar Sekunden einen Job ab, nicht in einer engen Schleife, oder nutze stattdessen Webhooks .

Gleichzeitige Renderings

Dein Plan legt fest, wie viele Renderings gleichzeitig ausgeführt werden können. Auch die Renders, die in der App gestartet sind, zählen. Wenn jeder Slot besetzt ist, gibt POST /v1/render 429 mit code: "CONCURRENT_LIMIT" zurück. Für dich wird nichts in die Warteschlange gestellt: Warte, bis ein laufender Auftrag fertig ist, und sende dann die Anfrage erneut.

Credits und Verwendung

• Jeder Render verbraucht Guthaben vom Kontostand. Wenn nicht genug vorhanden sind, wird der Render mit 402 (NO_CREDITS oder INSUFFICIENT_CREDITS) vor Beginn abgelehnt.
• Ein Rendering darf nicht mehr als ein festes Renderlimit pro Render kosten. Ein Rendering darüber wird mit 413 REQUEST_COST_TOO_HIGH abgelehnt. Verwenden Sie weniger Szenen, kürzere Szenen oder einen niedrigeren quality.
• Jeder Tarif hat ein monatliches Nutzungslimit. Wenn dieses erreicht ist, werden Renderings mit 402 ABUSE_CAP_EXCEEDED abgelehnt, bis der Monat zurückgesetzt wird oder der Tarif geändert wird.
• Jeder Plan hat eine Speicherzulage für fertige Videos. Wenn die Bibliothek voll ist, werden Renderings mit 402 STORAGE_FULL verweigert.

Siehe Konto und Abrechnung für die Allowances Ihres Plans.

Anfragelimits

Für POST /v1/render:

Spielfeld	Grenze
brief	1 bis 4.000 Zeichen
scene_plan	1 bis 12 Szenen
Szene prompt	1 bis 2.000 Zeichen
Szene script	bis zu 2.000 Zeichen
Szene duration	3 bis 10 Sekunden
duration_sec	5 bis 120 Sekunden
title	Bis zu 200 Zeichen
brand_name	Bis zu 80 Zeichen
category	Bis zu 60 Zeichen
language	2 bis 10 Charaktere
brand_colors	bis zu 12 Farben, jeweils 32 Zeichen
brand_logo_url, product_image_url	bis zu 5.000.000 Zeichen (genug für eine Daten-URI)
Idempotency-Key Kopfball	Die ersten 80 Zeichen werden verwendet

Für Webhooks:

Gegenstand	Grenze
Webhooks pro Konto	25
webhook_url	Bis zu 2.000 Zeichen, nur öffentliche HTTP(s)
description	Bis zu 200 Zeichen

Zeitlimits

Schritt	Grenze	Was passiert
Planung aus einem brief	etwa 60 Sekunden	502 PLAN_FAILED, Planungsgutschriften zurückerstattet.
Ein Render	Etwa eine Stunde	Der Job ist failed markiert und die Credits werden zurückerstattet.
Eine Webhook-Lieferung	10 Sekunden pro Versuch	Der Ball wird erneut versucht, bis zu drei Versuche.