# Workflow de transcription

Créez un processus fiable de téléversement, création, suivi et téléchargement du résultat

Canonical: https://alef-bot.top/fr/developers/guides/transcription-workflow

Updated: 2026-08-14

## 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. **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. **Transcrire.** Créez une tâche par téléversement. Si la réponse est incertaine, réutilisez le même Idempotency-Key
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. **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

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)