Limites

Des limites s’appliquent par compte. Toutes les clés d’un même compte les partagent.

Limites de taux

Extrémité	Par minute	Par heure	Par jour
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

Chaque rendu compte aussi dans la limite globale de rendu du compte de 5 par minute, 60 par heure et 300 par jour. Cette limite est partagée avec les rendus lancés dans l’application, donc une équipe occupée dans l’application laisse moins de place pour les API.

Les requêtes sont comptées en fenêtres fixes d’une minute, d’une heure et d’un jour. Lorsque vous dépassez, vous obtenez 429 avec code: "RATE_LIMITED" et le nombre de secondes d’attente, en retryAfter ou details.retryAfter:

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

GET /v1/me et GET /v1/job/{id} n’ont pas de limite de taux aujourd’hui. Interrogez un travail toutes les quelques secondes, pas en boucle serrée, ou utilisez plutôt des webhooks .

Rendus simultanés

Votre plan définit combien de rendus peuvent s’exécuter en même temps. Les rendus commencés dans l’application comptent aussi. Quand chaque emplacement est occupé, POST /v1/render retourne 429 avec code: "CONCURRENT_LIMIT". Rien n’est mis en file pour vous : attendez qu’un travail en cours se termine, puis envoyez la requête à nouveau.

Crédits et utilisation

• Chaque rendu dépense des crédits à partir du solde du compte. S’il n’y en a pas assez, le rendu est refusé avec 402 (NO_CREDITS ou INSUFFICIENT_CREDITS) avant de commencer.
• Un rendu ne peut pas coûter plus qu’une limite fixe par rendu. Un rendu par-dessus est refusé avec 413 REQUEST_COST_TOO_HIGH. Utilisez moins de scènes, des scènes plus courtes ou un quality plus faible .
• Chaque forfait a une limite d’utilisation mensuelle. Une fois atteinte, les rendus sont refusés avec 402 ABUSE_CAP_EXCEEDED jusqu’à ce que le mois soit réinitialisé ou que le forfait change.
• Chaque plan prévoit une marge de stockage pour les vidéos terminées. Lorsque la bibliothèque est pleine, les rendus sont refusés avec 402 STORAGE_FULL.

Consultez le compte et la facturation pour les allocations de votre forfait.

Limites de requêtes

Pour POST /v1/render:

Terrain	Limite
brief	1 à 4 000 caractères
scene_plan	1 à 12 scènes
Scène prompt	1 à 2 000 caractères
Scène script	jusqu’à 2 000 caractères
Scène duration	3 à 10 secondes
duration_sec	5 à 120 secondes
title	jusqu’à 200 caractères
brand_name	jusqu’à 80 caractères
category	jusqu’à 60 caractères
language	2 à 10 caractères
brand_colors	jusqu’à 12 couleurs, 32 caractères chacune
brand_logo_url, product_image_url	jusqu’à 5 000 000 de caractères (suffisant pour un URI de données)
Idempotency-Key en-tête	Les 80 premiers caractères sont utilisés

Pour les webhooks :

Objet	Limite
Webhooks par compte	25
webhook_url	jusqu’à 2 000 caractères, http(s) public(s) uniquement
description	jusqu’à 200 caractères

Limites de temps

Pas	Limite	Que se passe-t-il
Planification à partir d’un brief	environ 60 secondes	502 PLAN_FAILED, les crédits de planification ont été remboursés.
Un rendu	environ 1 heure	Le poste est marqué failed et ses crédits sont remboursés.
Une livraison par webhook	10 secondes par tentative	La livraison est retentée, jusqu’à 3 tentatives.