API de transcription : aperçu, authentification et limites
Utilisation de l'API REST de Voix2Texte : accès, clés vpt_live_, authentification Bearer, limites de requêtes et facturation par cycles.
L'API REST de Voix2Texte permet d'envoyer des audios par URL et de recevoir la transcription prête dans votre système, sans passer par le site. Elle utilise les mêmes moteurs et facture les mêmes cycles que les transcriptions effectuées dans le panneau.
Qui peut l'utiliser
L'API est disponible à partir du plan Profissional (R$ 39,90/mois). Y ont accès : Profissional, Premium, tous les plans Entreprise (mensuels et annuels) et les plans hérités équivalents. Si votre compte n'est pas éligible, les routes de clés renvoient l'erreur 403 PLAN_NOT_ELIGIBLE.
Clés API
Créez la clé
Copiez le secret immédiatement
vpt_live_... et n'est affichée qu'une seule fois, au moment de la création. Nous n'en conservons qu'un hash — il n'est pas possible de la récupérer ensuite.Conservez-la en sécurité
Vous avez perdu la clé ? Il n'y a aucun moyen de la réafficher. Révoquez l'ancienne clé et créez-en une nouvelle. Les clés compromises doivent être révoquées immédiatement.
La création de clés personnelles n'a pas encore d'écran dédié dans le panneau. Si votre plan est éligible et que vous souhaitez commencer à utiliser l'API, ouvrez un ticket et l'équipe activera l'accès avec vous.
Authentification
Chaque requête porte la clé dans l'en-tête Authorization :
Authorization: Bearer vpt_live_SUA_CHAVE
Une requête sans l'en-tête renvoie 401 MISSING_API_KEY.
Envoyer un audio pour transcription
L'endpoint de transcription se trouve sur la passerelle api.voxscriber.com :
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer vpt_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
"webhook_url": "https://seusistema.com/webhooks/vozparatexto",
"formats": ["txt", "srt"]
}'
Champs acceptés dans le corps : audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER ou ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata et idempotency_key. Le résultat arrive sur votre webhook_url — voir Webhooks et notifications.
Utilisez idempotency_key avec un identifiant qui vous est propre (ex. : l'ID de l'enregistrement dans votre système). Si la même requête est renvoyée par erreur, l'audio n'est pas traité — ni facturé — deux fois.
Limites
| Limite | Valeur |
|---|---|
| Requêtes par clé | 60 par minute |
| Audio téléchargé par URL | jusqu'à 500 Mo (timeout de 60 s) |
| Audio via passthrough (le moteur Premium lit l'URL directement) | jusqu'à 5 Go |
| Clés actives par compte | 20 |
Règles de sécurité sur les URL : uniquement https, sans redirections, et les adresses internes/privées sont bloquées. L'URL de l'audio doit être accessible publiquement.
Les formats d'exportation disponibles suivent les règles de votre plan, comme sur le site — les formats hors plan sont renvoyés listés dans exports_skipped.
Facturation
L'API débite les mêmes cycles qu'une transcription effectuée sur le site, selon le moteur choisi (Standard/Whisper : 1 cycle/min ; Premium : 4 cycles/min ; Ultra : 10 cycles/min). Il n'existe aujourd'hui ni quota mensuel d'appels ni plafond de dépense par clé — contrôlez la consommation via votre solde de cycles. Voir Ce que sont les cycles et combien coûte chaque minute.
FAQ
J'ai perdu ma clé API. Comment la récupérer ?
Il est impossible de la récupérer — seul le hash est conservé en base. Révoquez la clé perdue et créez-en une nouvelle.
L'API facture-t-elle plus cher que le site ?
Non. Le coût en cycles est identique, défini par le moteur et la durée de l'audio.
Puis-je envoyer le fichier directement au lieu d'une URL ?
Le canal principal est audio_url. Si vos audios n'ont pas d'URL publique, contactez le support pour évaluer le meilleur flux pour votre cas.
Existe-t-il une documentation OpenAPI ?
La spec publique dans /.well-known/openapi.json ne couvre aujourd'hui que les endpoints publics (statistiques et transcriptions partagées). Pour le reste, utilisez ce centre d'aide et le support.
Articles connexes
- Webhooks et notifications
- Automatiser avec l'API
- Ce que sont les cycles et combien coûte chaque minute
- Exporter vers d'autres outils
Pas résolu ? Ouvrez un ticket — notre équipe répond rapidement.