Limiti

Ci sono limiti per account. Tutte le chiavi su un solo account le condividono.

Limiti di tariffa

Punto finale	Al minuto	All’ora	Al giorno
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Ogni rendering conta anche per il limite complessivo di rendering dell’account: 5 al minuto, 60 all’ora e 300 al giorno. Questo limite viene condiviso con i render avviati nell’app, quindi un team impegnato nell’app lascia meno spazio per il API.

Le richieste vengono conteggiate in finestre fisse di un minuto, un’ora e un giorno. Quando superi, ottieni 429 con code: "RATE_LIMITED" e il numero di secondi di attesa, in retryAfter o details.retryAfter:

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

GET /v1/me e GET /v1/job/{id} oggi non hanno limite di tasso. Consulta un lavoro ogni pochi secondi, non in un loop stretto, oppure usa invece i webhook .

Rendering concorrenti

Il tuo piano stabilisce quanti render possono essere eseguiti contemporaneamente. Anche i rendering iniziati nell’app sono conteggiati. Quando ogni slot è occupato, POST /v1/render restituisce 429 con code: "CONCURRENT_LIMIT". Non c’è nulla in coda per te: aspetta che un lavoro in esecuzione finisca, poi invia di nuovo la richiesta.

Crediti e utilizzo

• Ogni render spende crediti dal saldo del conto. Se non ce ne sono sufficienti, il render viene rifiutato con 402 (NO_CREDITS o INSUFFICIENT_CREDITS) prima di iniziare.
• Un render non può costare più di un limite fisso per ogni render. Un rendering sopra di esso viene rifiutato con 413 REQUEST_COST_TOO_HIGH. Usa meno scene, scene più brevi o un quality inferiore.
• Ogni piano ha un limite mensile di utilizzo. Quando viene raggiunto, i rendering vengono rifiutati con 402 ABUSE_CAP_EXCEEDED fino a quando il mese si resetta o il piano cambia.
• Ogni piano prevede un’area per i video finiti. Quando la libreria è piena, i render vengono rifiutati con 402 STORAGE_FULL.

Vedi Account e fatturazione per le quote del tuo piano.

Limiti di richiesta

Per POST /v1/render:

Campo	Limite
brief	Da 1 a 4.000 caratteri
scene_plan	Da 1 a 12 scene
Scena prompt	Da 1 a 2.000 caratteri
Scena script	fino a 2.000 caratteri
Scena duration	3-10 secondi
duration_sec	5-120 secondi
title	fino a 200 caratteri
brand_name	fino a 80 caratteri
category	Fino a 60 caratteri
language	Da 2 a 10 caratteri
brand_colors	fino a 12 colori, 32 caratteri ciascuno
brand_logo_url, product_image_url	fino a 5.000.000 di caratteri (sufficienti per un URI dati)
Idempotency-Key intestazione	Vengono utilizzati i primi 80 caratteri

Per i webhook:

Voce	Limite
Webhook per account	25
webhook_url	Fino a 2.000 caratteri, solo http pubblici
description	fino a 200 caratteri

Limiti di tempo

Passo	Limite	Cosa succede
Pianificare da un brief	circa 60 secondi	502 PLAN_FAILED, rimborso dei crediti di pianificazione.
Un render	circa 1 ora	Il lavoro è segnato failed e i suoi crediti vengono rimborsati.
Una consegna tramite webhook	10 secondi per tentativo	La consegna viene ripetuta, fino a 3 tentativi.