Limites

Limites se aplicam por conta. Todas as chaves de uma conta compartilham.

Limites de taxa

Endpoint	Por minuto	Por hora	Por dia
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Cada renderização também conta para o limite geral de renderização da conta: 5 por minuto, 60 por hora e 300 por dia. Esse limite é compartilhado com renderizações iniciadas no app, então uma equipe ocupada no app deixa menos espaço para o API.

As solicitações são contadas em janelas fixas de um minuto, uma hora e um dia. Quando você ultrapassa, recebe 429 com code: "RATE_LIMITED" e o número de segundos para esperar, em retryAfter ou details.retryAfter:

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

GET /v1/me e GET /v1/job/{id} hoje não têm limite de taxa. Consulte um trabalho a cada poucos segundos, não em um ciclo apertado, ou use webhooks em vez disso.

Renders simultâneos

Seu plano define quantos renders podem rodar ao mesmo tempo. Renders iniciados no app também contam. Quando todos os espaços estão ocupados, POST /v1/render retorna 429 com code: "CONCURRENT_LIMIT". Nada está na fila para você: espere o trabalho em execução terminar e envie o pedido novamente.

Créditos e uso

• Cada renderização gasta créditos do saldo da conta. Se não houver créditos suficientes, a renderização é recusada com 402 (NO_CREDITS ou INSUFFICIENT_CREDITS) antes de começar.
• Uma renderização não pode custar mais do que um limite fixo por render. Uma renderização sobre ela é recusada com 413 REQUEST_COST_TOO_HIGH. Use menos cenas, cenas mais curtas ou um quality menor.
• Cada plano tem um limite mensal de uso. Quando é atingido, as renderizações são recusadas com 402 ABUSE_CAP_EXCEEDED até que o mês seja resetado ou o plano mude.
• Cada plano tem uma margem de armazenamento para vídeos finalizados. Quando a biblioteca está cheia, renderizações são recusadas com 402 STORAGE_FULL.

Veja Conta e faturamento para as perdenções do seu plano.

Limites de solicitações

Para POST /v1/render:

Campo	Limite
brief	1 a 4.000 caracteres
scene_plan	1 a 12 cenas
Cena prompt	1 a 2.000 caracteres
Cena script	Até 2.000 caracteres
Cena duration	3 a 10 segundos
duration_sec	5 a 120 segundos
title	Até 200 caracteres
brand_name	Até 80 caracteres
category	Até 60 caracteres
language	2 a 10 caracteres
brand_colors	Até 12 cores, 32 caracteres cada
brand_logo_url, product_image_url	até 5.000.000 de caracteres (suficiente para um URI de dados)
Idempotency-Key cabeçalho	Os primeiros 80 caracteres são usados

Para webhooks:

Item	Limite
Webhooks por conta	25
webhook_url	Até 2.000 caracteres, apenas http(s) público(s)
description	Até 200 caracteres

Limites de tempo

Passo	Limite	O que acontece
Planejamento a partir de um brief	cerca de 60 segundos	502 PLAN_FAILED, créditos de planejamento reembolsados.
Uma renderização	cerca de 1 hora	O trabalho é marcado failed e seus créditos são reembolsados.
Uma entrega por webhook	10 segundos por tentativa	A entrega é tentada novamente, até 3 tentativas.