Automatiser les transcriptions avec l’API : exemples pratiques
Recettes d’automatisation avec l’API Voix2Texte : envoyer des enregistrements par URL, choisir le moteur et les formats, utiliser idempotency_key et metadata, et tout recevoir par webhook.
Avec l’API, vous transformez n’importe quelle source d’enregistrements — téléphonie, enregistreur de réunions, système interne — en texte recherchable, sans intervention manuelle. Cet article présente le flux recommandé et des recettes prêtes à l’emploi. Avant cela, consultez les prérequis dans API de transcription (plan Profissional+ et clé vpt_live_).
Le flux recommandé
- Envoyez l’audio par URL avec un
webhook_url. - Recevez le callback quand il se termine (succès ou échec).
- Téléchargez les fichiers exportés via les liens du résultat — ils sont valables 7 jours.
Pas de polling : avec une limite de 60 requêtes/minute par clé, interroger le statut en boucle gaspille votre quota. Le webhook livre le résultat tout seul, avec jusqu’à 6 renvois si votre serveur est hors ligne.
Recette 1 — transcrire tout nouvel enregistrement
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer $VPT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://storage.suaempresa.com/calls/2026-08-02-0931.mp3",
"webhook_url": "https://api.suaempresa.com/hooks/vpt",
"formats": ["txt", "docx"],
"metadata": { "call_id": "0931", "agente": "maria" },
"idempotency_key": "call-2026-08-02-0931"
}'
metadatarevient dans le webhook — utilisez-le pour corréler le résultat avec l’enregistrement de votre système.idempotency_keygarantit que les renvois accidentels (retry de votre côté, déploiement en plein job) ne traitent ni ne facturent deux fois le même audio.
Recette 2 — choisir le moteur selon le coût
Le champ engine accepte ASSEMBLYAI (Premium, par défaut), WHISPER (Standard) et ELEVENLABS (Ultra). Pour un volume élevé où le coût importe plus que la finition, utilisez Whisper — 1 cycle/min contre 4 pour Premium :
-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'
Règle pratique : Premium pour les réunions et les entretiens importants ; Standard (Whisper) pour un volume élevé et un audio avec du bruit ; Ultra lorsque la séparation des locuteurs doit être impeccable (disponible sur Profissional+).
Recette 3 — sous-titres automatiques
Demandez formats: ["srt", "vtt"] et recevez les sous-titres prêts pour YouTube ou les lecteurs web directement dans le webhook. Détails de chaque format dans Exporter vers d’autres outils.
Limites qui affectent les automatisations
| Item | Règle |
|---|---|
| Rate limit | 60 req/min par clé |
audio_url | uniquement https, publique, jusqu’à 500 MB (téléchargement) ou 5 GB via passthrough avec le moteur Premium |
| Formats | suivent les limitations de votre plan ; ceux non autorisés reviennent dans exports_skipped |
| Liens de téléchargement | expirent après 7 jours (la transcription reste dans la bibliothèque) |
| Cycles | mêmes coûts que sur le site, débités du même solde |
Surveillez votre solde de cycles : il n’existe actuellement aucun plafond de dépenses par clé. Une automatisation avec une boucle incontrôlée consomme du solde réel. L’idempotency_key est votre première ligne de défense.
FAQ
Comment reçois-je le texte final — via le webhook ou dois-je le télécharger ?
Le webhook apporte le dénouement et les liens des fichiers exportés dans les formats demandés. Téléchargez les fichiers dans un délai de 7 jours ; après cela, le contenu reste disponible dans la bibliothèque du site.
Puis-je définir la langue de l’audio ?
Oui, via le champ language. Sans lui, la valeur par défaut du compte s’applique ; la détection automatique est également prise en charge par les moteurs.
Et si deux systèmes envoient le même audio ?
Utilisez le même idempotency_key sur les deux — seul le premier traite et facture.
L’automatisation fonctionne-t-elle pour les membres de l’organisation ?
Oui — et la consommation suit les règles du plan de l’entreprise. Pour l’audit des appels à grande échelle, consultez l’API dédiée.
Articles connexes
Pas résolu ? Ouvrez un ticket — notre équipe répond rapidement.