Workflow de transcription

Téléverser → Transcrire → Suivre → Télécharger

Traitez chaque opération comme une étape distincte et conservez upload_id et job_id pour faciliter les reprises et le support

1. 1

   Téléverser

   Réservez un emplacement et transférez le fichier avant expiration. Une taille différente de celle déclarée est refusée

2. 2

   Transcrire

   Créez une tâche par téléversement. Si la réponse est incertaine, réutilisez le même Idempotency-Key

3. 3

   Suivre

   Interrogez avec des délais croissants. Envoyez le dernier ETag dans If-None-Match pour recevoir 304 si rien n’a changé

4. 4

   Télécharger

   Téléchargez après la fin de la tâche. SRT, TXT, PDF et DOCX sont disponibles ; choisissez avec format, l’extension du chemin ou Accept

Comportement en production

• Les tâches Live renvoient généralement 202 Accepted ; les tâches Test peuvent renvoyer 200 immédiatement
• Le téléversement et la création de transcriptions sont limités à 15 requêtes/min en Premium et 60 en Platinum
• Les lectures, le suivi et les résultats sont limités à 60 requêtes/min en Premium et 240 en Platinum
• Les tests Webhook sont limités à 5 requêtes/min en Premium et 20 en Platinum
• Toutes les clés du compte partagent les quotas ; chaque groupe d’opérations est compté séparément
• X-RateLimit-Reset est un horodatage Unix en secondes UTC ; pour 429, respectez aussi Retry-After en secondes entières
• Conservez X-Request-ID en cas d’échec pour permettre au support AlefBot de retrouver la requête