Déposer la transcription d'une leçon dans une langue
put
https://mudey.fr/api/v1/courses/{courseId}/lessons/{lessonId}/transcripts/{language}courses:writeContenu d'un fichier .vtt ou .srt, ou texte (txt). Un texte dont chaque ligne commence par un horodatage « [01:23] » garde son minutage. Remplace la transcription de cette langue, y compris une transcription automatique ; visible des élèves aussitôt. isOriginal (par défaut : la langue de la formation) marque la langue parlée dans la vidéo, une seule par leçon.
En-tête Authorization: Bearer mudey_sk_… obligatoire. Créer et utiliser une clé
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
| courseId* | chemin | string | |
| lessonId* | chemin | string | |
| language* | chemin | string | Code de langue ISO 639-1 (fr, en, nl, de, es…). |
Corps JSON
Les champs marqués * sont obligatoires.
| Champ | Type | Description |
|---|---|---|
| format | vtt | srt | txt | Format du contenu ; txt par défaut. |
| content* | string | Contenu du fichier, ou texte. 2 Mo au plus, 400 000 caractères de texte retenu. |
| isOriginal | boolean | Langue parlée dans la vidéo. Par défaut : vrai si c'est la langue de la formation. |
Réponses
200Transcription enregistrée.401Clé absente, invalide, révoquée ou expirée.403Droit manquant sur la clé, ou compte qui n'est plus formateur.404Ressource introuvable dans vos formations.409Leçon reliée à une autre formation (mirrored_lesson).422Langue non prise en charge (invalid_language), fichier illisible (invalid_transcript) ou leçon non vidéo (not_video_lesson).429Quota dépassé (300 appels par minute et par clé). Voir l'en-tête Retry-After.
Exemple
export MUDEY_API_KEY="mudey_sk_..."
export COURSE_ID="..." # à remplacer
export LESSON_ID="..." # à remplacer
export LANGUAGE="..." # à remplacer
curl -X PUT "https://mudey.fr/api/v1/courses/$COURSE_ID/lessons/$LESSON_ID/transcripts/$LANGUAGE" \
-H "Authorization: Bearer $MUDEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"format": "srt",
"content": "1\n00:00:00,000 --> 00:00:04,200\nBonjour et bienvenue dans cette formation.\n\n2\n00:00:04,200 --> 00:00:08,000\nOn commence par installer TypeScript.\n"
}'