Granice

Limity obowiązują dla każdego konta. Wszystkie klucze na jednym koncie mają wspólne warunki.

Limity stawek

Punkt końcowy	Na minutę	Na godzinę	Na dzień
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Każdy render jest również wliczany do ogólnego limitu renderowania konta wynoszącego 5 na minutę, 60 na godzinę i 300 na dzień. Ten limit jest współdzielony z renderami rozpoczętymi w aplikacji, więc zapracowany zespół w aplikacji zostawia mniej miejsca na API.

Żądania są liczone w stałych oknach: jedna minuta, godzina i jeden dzień. Gdy przekraczasz granicę, otrzymujesz 429 z code: "RATE_LIMITED" i liczbą sekund oczekiwania, w retryAfter lub details.retryAfter:

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

GET /v1/me i GET /v1/job/{id} dziś nie mają limitu cen. Pytaj o pracę co kilka sekund, nie w wąskiej pętli, albo używaj webhooków .

Renderowania współczesne

Twój plan określa, ile renderów może działać jednocześnie. Rendery rozpoczęte w aplikacji też się liczą. Gdy każdy slot jest zajęty, POST /v1/render zwraca 429 z code: "CONCURRENT_LIMIT". Nic nie jest dla ciebie kolejkowane: czekaj na zakończenie działającego zadania, a potem wysyłaj żądanie ponownie.

Kredyty i wykorzystanie

• Każdy render wydaje kredyty ze salda konta. Jeśli jest ich za mało, renderowanie jest odrzucane z 402 (NO_CREDITS lub INSUFFICIENT_CREDITS) przed rozpoczęciem.
• Jeden render nie może kosztować więcej niż stały limit na render. Renderowanie na nim jest odrzucane z 413 REQUEST_COST_TOO_HIGH. Używaj mniej scen, krótszych lub niższych quality.
• Każdy plan ma miesięczny limit zużycia. Gdy zostanie osiągnięty, rendery są odrzucane z 402 ABUSE_CAP_EXCEEDED do czasu resetu miesiąca lub zmiany planu.
• Każdy plan ma limit przechowywania na gotowe filmy. Gdy biblioteka jest pełna, rendery są odrzucane z 402 STORAGE_FULL.

Zobacz Konto i rozliczenia dotyczące limitów w Twoim planie.

Limity żądań

Dla POST /v1/render:

Pole	Limit
brief	od 1 do 4 000 znaków
scene_plan	Od 1 do 12 scen
Scena prompt	od 1 do 2 000 znaków
Scena script	do 2 000 znaków
Scena duration	3 do 10 sekund
duration_sec	5 do 120 sekund
title	do 200 znaków
brand_name	do 80 znaków
category	do 60 znaków
language	2 do 10 znaków
brand_colors	do 12 kolorów, po 32 znaki każdy
brand_logo_url, product_image_url	do 5 000 000 znaków (wystarczająco na URI danych)
Idempotency-Key nagłówek	Pierwsze 80 znaków jest używanych

Jeśli chodzi o webhooki:

Przedmiot	Limit
Webhooki na konto	25
webhook_url	do 2 000 znaków, tylko publiczne http(y)
description	do 200 znaków

Limity czasowe

Krok	Limit	Co się dzieje
Planowanie z brief	około 60 sekund	502 PLAN_FAILED, kredyty planowania zwracane.
Render	około godziny	Praca jest oceniana failed a jej punkty są zwracane.
Dostawa przez webhook	10 sekund na próbę	Próba podania jest powtarzana, do 3 prób.