Ephia Logo
Ephia Docs
Démarrage
Référence API
SDKs
Guides
Référence APILimites & quotasIndex

Limites & quotas

Limites d’utilisation par plan et gestion des quotas.

Limites par plan

Plan Free (Essai)

  • Concurrence : 1 session simultanée
  • Quota mensuel : 60 minutes de transcription
  • Rate limit : 10 requêtes/minute
  • Durée max session : 30 minutes
  • Support : Communauté uniquement

Plan Starter (€49/mois)

  • Concurrence : 3 sessions simultanées
  • Quota mensuel : 500 minutes incluses
  • Rate limit : 60 requêtes/minute
  • Durée max session : 2 heures
  • Support : Email (48h)

Plan Professional (€199/mois)

  • Concurrence : 10 sessions simultanées
  • Quota mensuel : 2500 minutes incluses
  • Rate limit : 200 requêtes/minute
  • Durée max session : 8 heures
  • Support : Email prioritaire (24h)

Plan Enterprise (Sur devis)

  • Concurrence : Illimité
  • Quota mensuel : Sur mesure
  • Rate limit : Sur mesure
  • Durée max session : Illimité
  • Support : Dédié (SLA garanti)

Ce qui est facturé

  • Unité de facturation : Minute d’audio traité
  • Arrondi : À la minute supérieure (ex: 1m30s = 2 minutes)
  • Période : Mensuelle
  • Dépassement : Facturé au prix/minute du plan

Exemple de calcul

Plan Starter (€49/mois, 500 min incluses) :

  • Utilisation : 750 minutes
  • Facture : €49 + (750 - 500) × €0.15 = €86.50

Rate limits

Fenêtre glissante

  • Durée : 60 secondes
  • Comportement : Fenêtre glissante (pas fixe)

Headers de réponse

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640995200
Retry-After: 5

Comportement en cas de dépassement

  • HTTP 429 : Rate limit dépassé
  • Retry-After : Délai en secondes avant nouvelle tentative
  • Reconnexion automatique : Non recommandée (attendre le délai)

Limites de concurrence

Définition

Nombre de sessions WebSocket simultanées actives.

Scope

  • Niveau : Par organisation (pas par clé API)
  • Comportement : Nouvelle connexion rejetée si limite atteinte
  • Erreur : CONCURRENCY_LIMIT_EXCEEDED

Gestion recommandée

  • Pool de connexions pour applications multi-utilisateurs
  • Queue de sessions en attente
  • Retry avec backoff exponentiel

Rate limits par endpoint

EndpointFreeStarterProfessionalEnterprise
/v1/live/sessions (POST)10/min60/min200/minSur mesure
/v1/audio/live (WS)1310Illimité
/v1/batch (POST)5/min30/min100/minSur mesure

Erreurs typiques

HTTP 429 : Rate limit dépassé

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 5 seconds.",
    "retry_after": 5
  }
}

Solution : Attendre le délai indiqué dans retry_after

WebSocket error : Concurrence maximale atteinte

{
  "type": "error",
  "code": "CONCURRENCY_LIMIT_EXCEEDED",
  "message": "Maximum concurrent sessions reached",
  "retry_after_ms": 0
}

Solution : Fermer une session existante ou augmenter le plan

IndexIndex