Limites et quotas

Deux mécanismes indépendants protègent la plateforme et votre compte : une limite de débit sur le nombre de requêtes, et un quota de traitement en parallèle sur le nombre de réunions et de documents traités en même temps.

Limite de débit

Chaque identifiant (clé API ou connexion OAuth) dispose d’un budget de requêtes sur une fenêtre glissante d’une minute :

Offre	Requêtes par minute
Free	30
Standard	60
Pro	120

Chaque réponse vous indique où vous en êtes :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1760436180

X-RateLimit-Reset est un timestamp Unix (secondes). Au-delà de la limite, vous recevez 429 rate_limited avec un en-tête Retry-After (secondes). Tous les endpoints sont comptabilisés, y compris le polling de GET /jobs/{id} : effectuez le polling toutes les 10 à 30 secondes, ou utilisez les webhooks.

Quota de traitement en parallèle

Transcrire une réunion et générer un document sont des opérations lourdes. Votre offre autorise un nombre fixe d’opérations en même temps, comptabilisées conjointement pour l’application web et l’API (un enregistrement traité dans l’application web occupe aussi un emplacement). Ce nombre dépend de votre offre et est affiché sur la page Gérer mon abonnement de l’application web (menu utilisateur).

Lorsque tous les emplacements sont occupés, POST /v1/meetings et POST /v1/meetings/{id}/documents répondent :

{
  "type": "https://meetingize.com/docs/api/errors#parallel_processing_limit",
  "title": "Parallel processing limit reached",
  "status": 429,
  "detail": "Your plan allows 3 simultaneous processing(s) (meetings and document generations, webapp and API together); 3 are running. Retry when one finishes (see GET /jobs?status=processing).",
  "code": "parallel_processing_limit"
}

avec Retry-After: 30. Rien n’est créé et rien n’est facturé. Pour voir ce qui est en cours d’exécution :

curl -s "https://app.meetingize.com/api/v1/jobs?status=processing" -H "Authorization: Bearer $MEETINGIZE_API_KEY"
curl -s "https://app.meetingize.com/api/v1/jobs?status=queued" -H "Authorization: Bearer $MEETINGIZE_API_KEY"

Les documents demandés à la création d’une réunion (document_templates, persona) sont générés après le compte rendu dans le cadre de la même requête : ils n’ont pas besoin d’un emplacement libre au démarrage.

Envoyer de nombreux fichiers

Pour importer un lot d’enregistrements, maintenez une file d’attente locale : envoyez une nouvelle réunion à chaque fois qu’une autre se termine (sur processing.completed ou lorsqu’un job atteint completed / failed), et en cas de 429 parallel_processing_limit, attendez Retry-After avant de réessayer avec la même Idempotency-Key.

Autres limites

Limite	Valeur
Taille de fichier envoyée	2 Go (413 file_too_large)
Taille de page (limit)	100 éléments max sur les listes
metadata	objet JSON, 4 Ko max
Tags par réunion	20
Participants par réunion	50
Documents demandés à la création d’une réunion	5
Prompt personnalisé pour un document	20 000 caractères
Message de feedback	10 000 caractères
Clés d’idempotence	255 caractères, conservées 24 heures

L’usage de l’API est aussi plafonné par votre enveloppe mensuelle et le plafond de dépense que vous choisissez : voir facturation.

Gérer correctement les 429

1. Lisez Retry-After et attendez au moins ce délai.
2. Réessayez avec un backoff exponentiel si cela se reproduit (par exemple 30 s, 60 s, 120 s).
3. Conservez la même Idempotency-Key pour les tentatives de POST.
4. Ne réessayez pas en boucle serrée : cela consomme votre limite de débit et vous retarde davantage.