Transcrire un fichier

POST /v1/transcribe reçoit un fichier audio et renvoie le texte dans la même réponse. C’est la voie la plus simple pour les enregistrements courts.

Requête

Envoyez un formulaire multipart/form-data :

Les autres réglages de découpage sont décrits dans la référence.

curl https://api.lexiafrik.com/v1/transcribe \
  -H "X-API-Key: $LEXIAFRIK_API_KEY" \
  -F "file=@entretien.m4a" \
  -F "language=wo-SN" \
  -F "include_segments=true"

Réponse

{
  "success": true,
  "request_id": "a1b2c3d4",
  "language": "wo-SN",
  "full_text": "Texte complet de l’enregistrement.",
  "n_segments": 2,
  "total_duration_s": 12.8,
  "segments": [
    { "index": 0, "start_s": 0.4, "end_s": 6.1, "duration_s": 5.7, "text": "Premier segment." },
    { "index": 1, "start_s": 6.5, "end_s": 12.8, "duration_s": 6.3, "text": "Second segment." }
  ]
}

• full_text : le texte complet, segments assemblés dans l’ordre.
• segments (si demandé) : chaque segment avec sa position dans l’audio d’origine (start_s, end_s), et une audio_url temporaire vers l’audio du segment quand l’audio est conservé.
• request_id : identifiant de la transcription, à utiliser pour la retrouver dans l’historique.

Segmentation

L’audio est découpé aux silences : le texte de chaque segment est transcrit séparément, puis l’ensemble est remis dans l’ordre. Si votre audio contient des pauses très courtes, baissez min_silence_ms ; s’il est bruité, laissez la valeur par défaut.

Retrouver et corriger ensuite

Chaque transcription est conservée dans votre historique :

• GET /v1/transcriptions : la liste, filtrable ;
• GET /v1/transcriptions/{request_id} : le détail ;
• PATCH /v1/transcriptions/{request_id} et …/segments/{segment_id} : corrections et étiquettes ;
• DELETE /v1/transcriptions/{request_id} : suppression, fichiers compris.

Détails des champs dans la référence.

Erreurs fréquentes