▶Sommaire API

Documentation Votxt OpenAPI

Beta Votxt OpenAPI est en beta. Testez vos integrations en developpement avant la production.

Apercu

Votxt OpenAPI permet d'ajouter la transcription audio et video a vos applications et automatisations.

Importez un fichier ou utilisez une URL externe, creez une tache de transcription puis suivez son etat.

Une fois terminee, exportez les transcriptions, sous-titres et donnees structurees dans plusieurs formats.

URL de base

https://api.votxt.co

Authentification

Envoyez votre cle API dans l'en-tete de requete. L'acces API exige un forfait actif compatible.

X-API-Key: your_api_key_here

Ouvrez les parametres de votre compte.
Verifiez que votre forfait inclut l'acces API.
Creez une cle API et conservez-la en securite.

Import de fichiers

Utilisez l'import direct avec URL signee ou fournissez une URL publique de fichier externe.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

Transcription

Point d'acces	Methode	Description
/api/v1/transcriptions	POST	Import de fichiers
/api/v1/transcriptions/youtube	POST	Lien vidéo
/api/v1/transcriptions	GET	Transcriptions
/api/v1/transcriptions/{id}	GET	Éditeur de transcription
/api/v1/transcriptions/{id}/status	GET	Statut

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

Statut

Statut	Transcription
queued	En attente
preprocessing	Pretraitement
processing	Traitement
completed	Termine
failed	Echec

Exports