Importer de l'audio par URL et via l'API

En plus de l'import de fichier, deux parcours sont possibles « sans fichier en main » : coller une URL de média dans l'interface (pour tout utilisateur) et envoyer via l'API (pour les plans Profissional et supérieurs) — idéal pour intégrer la transcription à des systèmes, des PABX et des automatisations.

1. Importer par URL dans l'interface

Sur l'écran Nouvelle transcription, la même option qui accepte YouTube accepte aussi les URLs directes de fichiers audio/vidéo (https). Le serveur télécharge le média puis suit le flux normal : choix de la langue (ou détection automatique), moteur du plan et coût en cycles selon la durée. Les limites de durée et de taille de votre plan s'appliquent de la même façon.

2. API de transcription

Qui peut l'utiliser

L'API est disponible à partir du plan Profissional (R$ 39,90/mois) — y compris Premium, plans entreprise et hérités équivalents. Sur les autres plans, la création de clé renvoie que le plan n'est pas éligible.

Clés API

• Format du jeton : vpt_live_... ;
• Le secret est affiché une seule fois, à la création — conservez-le dans un coffre. Nous ne conservons pas le secret, seulement une empreinte numérique de celui-ci ;
• Jusqu'à 20 clés actives par compte ; révoquez n'importe laquelle à tout moment ;
• La zone de gestion des clés personnelles de l'interface est en cours de déploiement — si vous ne trouvez pas l'option dans votre compte, ouvrez un ticket et nous l'activons pour vous.

Comment fonctionne un appel

Authentification par en-tête Authorization: Bearer vpt_live_.... Dans le corps, vous indiquez l'URL de l'audio (audio_url, uniquement https), l'URL de votre webhook pour recevoir le résultat, et éventuellement le moteur, la langue, les formats d'exportation et une clé d'idempotence.

• Limite de débit : 60 requêtes par minute et par clé ;
• Taille : audio par URL jusqu'à 500 Mo à télécharger sur le serveur ; avec le moteur Premium, les URLs jusqu'à 5 Go peuvent être lues directement par le moteur, sans téléchargement intermédiaire ;
• Coût : les mêmes cycles que le site, selon la durée et le moteur.

Réception du résultat (webhooks)

Le résultat arrive par webhook signé avec HMAC-SHA256 (en-têtes X-VPT-Signature et X-VPT-Event) — validez la signature avant de faire confiance au payload. Si votre endpoint est hors ligne, nous renvoyons avec un recul progressif : jusqu'à 6 tentatives sur ~24 heures.

Questions fréquentes

J'ai perdu le secret de la clé. Comment le récupérer ?

Il n'est pas possible de le récupérer — révoquez la clé et créez-en une autre. Le secret n'existe qu'au moment de la création.

L'API a-t-elle une documentation ?

La référence complète d'intégration est fournie lors de l'activation de l'accès. Ouvrez un ticket en indiquant votre cas d'usage.

Puis-je choisir le moteur et la langue dans l'appel ?

Oui, les deux sont des paramètres facultatifs — sans eux, le moteur par défaut du plan et la détection de la langue s'appliquent.

L'API facture-t-elle différemment du site ?

Non. Mêmes cycles, mêmes règles (y compris la remise uniquement après succès).

Comment révoquer une clé compromise ?

Révoquez-la immédiatement dans la gestion des clés (ou via le support). La révocation coupe l'accès immédiatement.

Articles associés

• API de transcription (vue d'ensemble)
• Webhooks
• Transcrire une vidéo YouTube
• Comment choisir le bon plan

---

Vous n'avez pas trouvé de réponse ? Ouvrez un ticket — les tickets de priorité normale reçoivent une réponse sous 24 heures.