API de transcription
Soumettez des médias pour la transcription IA et la création de projet. Supporte les fichiers Vidéo et Audio.
POST
/api/v1/transcribeImplémentation rapide
curl -X POST https://api.srtgen.com/api/v1/transcribe \ -H "x-api-key: <YOUR_API_KEY>" \ -F "file=@/path/to/your/video.mp4"
POSThttps://api.srtgen.com/api/v1/transcribe
Paramètres de la requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
file | File | Yes | Le fichier média à transcrire (Multipart). Supportés : Vidéo (mp4, mov, avi, webm, mkv), Audio (mp3, wav, m4a, flac). Max 2 Go. |
videoUrl | String | No* | URL externe du média (requis si aucun fichier n'est fourni dans le corps). |
name | String | No | Nom personnalisé pour le projet. |
languageCode | String | No | Code de langue source (ex: 'fr-fr'). Par défaut sur 'auto' (détection automatique) si omis. |
filterProfanity | Boolean | No | Censure automatique des termes explicites. Par défaut : false. |
disfluencies | Boolean | No | Inclure les mots de remplissage (ex: 'euh', 'ah'). Par défaut : false. |
medicalMode | Boolean | No | Transcription optimisée pour l'audio médical. Par défaut : false. |
Avancé : URL + Paramètres IA
curl -X POST https://api.srtgen.com/api/v1/transcribe \ -H "x-api-key: <YOUR_API_KEY>" \ -F "videoUrl=https://example.com/medical_lecture.mp4" \ -F "languageCode=en-us" \ -F "filterProfanity=true" \ -F "disfluencies=false" \ -F "medicalMode=true"
POSThttps://api.srtgen.com/api/v1/transcribe
Réponse de succès
Une requête réussie renvoie un statut 200 OK avec les détails du projet et de la tâche en arrière-plan.
- projectIdL'identifiant unique de votre projet.
- status'inProgress' (transcription en cours).
- Note : Les crédits sont calculés et déduits de votre solde de manière asynchrone une fois le processus de transcription finalisé.
{ "success": true, "projectId": "proj_8k2n9m1b", "status": "inProgress" }
Codes d'erreur
| Statut | Code d'erreur | Description |
|---|---|---|
| 400 | missing_file | Aucun fichier trouvé dans le champ 'file' ou 'video'. |
| 400 | unreachable_url | L'URL videoUrl fournie est inaccessible ou a renvoyé une erreur. |
| 400 | invalid_parameter | L'un des paramètres (ex: videoUrl) est malformé. |
| 400 | file_read_failed | Le fichier téléchargé n'a pas pu être lu ou est corrompu. |
| 401 | unauthorized | La clé API est manquante ou invalide. |
| 403 | insufficient_balance | Vous n'avez pas assez de crédits pour traiter la durée de ce média. |
| 403 | storage_quota_exceeded | Le fichier dépasse le quota de stockage cloud restant de votre forfait. |
| 413 | payload_too_large | Le fichier dépasse la limite absolue de téléchargement du système de 2 Go. |
| 500 | transcription_failed | La tâche de transcription n'a pas pu être initiée (panne du fournisseur d'IA). |
| 500 | server_error | Une erreur est survenue, veuillez réessayer plus tard. |
Structure de la réponse d'erreur
{ "success": false, "error": "insufficient_balance", "message": "Votre projet nécessite 5 crédits, mais votre solde est de 2." }
Cette page vous a-t-elle été utile ?