Historique, corrections et étiquettes

Chaque transcription est conservée dans votre historique. Vous pouvez la retrouver, corriger son texte, l’annoter avec des étiquettes, et la supprimer.

Le texte reconnu par la machine (text) n’est jamais écrasé : une correction est stockée à part (edited_text). Vous pouvez donc toujours comparer, ou revenir en arrière.

Retrouver ses transcriptions

curl "https://api.lexiafrik.com/v1/transcriptions?page=1&page_size=20&status=success" \
  -H "X-API-Key: $LEXIAFRIK_API_KEY"

Paramètre	Description
`page`, `page_size`	Pagination (20 par page par défaut, 100 au maximum).
`status`	`processing`, `success` ou `error`.
`cs_language`	Langue détectée dans le texte (`wo`, `fr`, `en`, `ar`).

La réponse contient items (une ligne par transcription : request_id, status, text, edited_text, language, duration_s, tags…) et total.

GET /v1/transcriptions/{request_id} renvoie le détail avec les segments (segments, segments_total).

Les segments

curl "https://api.lexiafrik.com/v1/transcriptions/a1b2c3d4/segments?limit=50&q=salaam" \
  -H "X-API-Key: $LEXIAFRIK_API_KEY"

Paramètre	Description
`offset`, `limit`	Pagination. Sans `limit`, tous les segments sont renvoyés (export complet).
`q`	Recherche dans le texte, le texte corrigé, les étiquettes et la langue.

Chaque segment : id, segment_index, start_s, end_s, text, edited_text, tags, audio_url (lecture temporaire de l’audio du segment) et cs_languages.

Corriger un texte

# Toute la transcription
curl -X PATCH https://api.lexiafrik.com/v1/transcriptions/a1b2c3d4 \
  -H "X-API-Key: $LEXIAFRIK_API_KEY" -H "Content-Type: application/json" \
  -d '{"edited_text": "Salaam aleekum, nanga def ?"}'

# Un seul segment
curl -X PATCH https://api.lexiafrik.com/v1/transcriptions/a1b2c3d4/segments/812 \
  -H "X-API-Key: $LEXIAFRIK_API_KEY" -H "Content-Type: application/json" \
  -d '{"edited_text": "Nanga def ?"}'

Un champ absent reste inchangé ; edited_text à null ou vide efface la correction.
Quand vous corrigez un segment, le texte global corrigé est recalculé à partir des segments et renvoyé dans transcription_edited_text.
Le texte corrigé peut faire jusqu’à 200 000 caractères.

Étiquettes

Une étiquette est une paire key / value (clé jusqu’à 64 caractères, valeur jusqu’à 256), utile pour classer ou signaler ({"key": "revue", "value": "à vérifier"}). On peut en poser jusqu’à 50 par transcription ou par segment.

curl -X PATCH https://api.lexiafrik.com/v1/transcriptions/a1b2c3d4 \
  -H "X-API-Key: $LEXIAFRIK_API_KEY" -H "Content-Type: application/json" \
  -d '{"tags": [{"key": "projet", "value": "radio"}, {"key": "revue", "value": "ok"}]}'

Envoyer tags remplace toute la liste : pour ajouter une étiquette, renvoyez aussi les existantes. tags: [] les supprime toutes.

Supprimer

Route	Effet
`DELETE /v1/transcriptions/{request_id}`	Supprime la transcription, ses segments et tous ses fichiers audio. Irréversible. Réponse `409` si elle est encore en cours de traitement.
`DELETE /v1/transcriptions/{request_id}/segments/{segment_id}`	Supprime un segment ; le texte global corrigé est recalculé.

La réponse d’une suppression indique files_not_deleted : le nombre de fichiers qui n’ont pas pu être effacés du stockage (normalement 0).

Réécouter l’audio

Route	Contenu
`GET /v1/transcriptions/{request_id}/audio`	URL temporaire de l’audio complet.
`GET /v1/transcriptions/{request_id}/segments/{segment_id}/audio`	URL temporaire de l’audio d’un segment.

Ces adresses expirent au bout d’une heure (expires_in: 3600) : redemandez-les au besoin. Elles n’existent que si l’audio a été conservé (keep_audio à true, valeur par défaut).

Erreurs

Code	Cause
`404`	Transcription ou segment inconnu, ou qui n’appartient pas à votre compte.
`409`	Suppression d’une transcription encore en cours de traitement.
`422`	Corps de requête invalide (étiquette trop longue, texte trop long…).

Les routes complètes sont dans la référence.

Temps réel (WebSocket)Équipes