Grenzen

Er gelden limieten per account. Alle sleutels van één account delen ze.

Tarieflimieten

Eindpunt	Per minuut	Per uur	Per dag
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Elke render telt ook mee voor de totale renderlimiet van het account : 5 per minuut, 60 per uur en 300 per dag. Die limiet wordt gedeeld met renders die in de app worden gestart, zodat een druk team in de app minder ruimte laat voor de API[ .

Verzoeken worden geteld in vaste vensters van één minuut, één uur en één dag. Wanneer je erheen gaat, krijg je 429 met code: "RATE_LIMITED" en het aantal seconden wachten, in retryAfter of details.retryAfter:

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

GET /v1/me en GET /v1/job/{id} hebben vandaag geen snelheidslimiet. Poll elke paar seconden een job, niet in een strakke lus, of gebruik in plaats daarvan webhooks .

Gelijktijdige renders

Je plan stelt in hoeveel renders tegelijk kunnen draaien. Renders die in de app zijn gestart tellen ook mee. Wanneer elke slot bezet is, geeft POST /v1/render 429 terug met code: "CONCURRENT_LIMIT". Er staat niets voor je in de wachtrij: wacht tot een lopende taak klaar is, en stuur dan het verzoek opnieuw.

Credits en gebruik

• Elke render gebruikt credits van het saldo van de rekening. Als er niet genoeg zijn, wordt de render geweigerd met 402 (NO_CREDITS of INSUFFICIENT_CREDITS) voordat het begint.
• Eén render mag niet meer kosten dan een vaste limiet per render. Een render erover wordt geweigerd met 413 REQUEST_COST_TOO_HIGH. Gebruik minder scènes, kortere scènes of een lagere quality.
• Elk abonnement heeft een maandelijkse gebruikslimiet. Wanneer deze is bereikt, worden renders met 402 ABUSE_CAP_EXCEEDED geweigerd totdat de maand wordt gereset, of het abonnement verandert.
• Elk abonnement heeft een opslagruimte voor voltooide video’s. Wanneer de bibliotheek vol is, worden renderings geweigerd met 402 STORAGE_FULL.

Bekijk Rekening en facturering voor de toelagen van je plan.

Verzoeklimieten

Voor POST /v1/render:

Veld	Limiet
brief	1 tot 4.000 tekens
scene_plan	1 tot 12 scènes
scène prompt	1 tot 2.000 tekens
scène script	tot 2.000 tekens
scène duration	3 tot 10 seconden
duration_sec	5 tot 120 seconden
title	Tot 200 tekens
brand_name	tot 80 tekens
category	tot 60 tekens
language	2 tot 10 personages
brand_colors	tot 12 kleuren, elk 32 tekens
brand_logo_url, product_image_url	tot 5.000.000 tekens (genoeg voor een data-URI)
Idempotency-Key kopstuk	De eerste 80 tekens worden gebruikt

Voor webhooks:

Item	Limiet
Webhooks per account	25
webhook_url	tot 2.000 tekens, alleen openbare http(s)
description	Tot 200 tekens

Tijdslimieten

Step	Limiet	Wat gebeurt er
Plannen vanuit een brief	ongeveer 60 seconden	502 PLAN_FAILED, planningscredits terugbetaald.
Een render	ongeveer 1 uur	De baan wordt gemarkeerd failed en de tegoed worden terugbetaald.
Een webhook-levering	10 seconden per poging	De bal wordt opnieuw geprobeerd, tot 3 pogingen.