Référence de l'API

Créer une transcription

Transformez n'importe quel fichier média hébergé en sous-titres précis et horodatés sans que personne n'ouvre le studio — alimentez directement votre CMS, vos archives ou votre chaîne de publication.

La durée du média est analysée avant l'acceptation de la requête ; le portefeuille est débité et la tâche mise en file d'attente en une seule étape atomique. Renvoie 201 avec la ressource de transcription.

Crédits: 4 crédits par minute de média entamée, débités à l'acceptation de la tâche. Les tâches échouées sont remboursées automatiquement.

curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/interview.mp4",
    "language": "en",
    "diarization": true
  }'

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Lister les transcriptions

Rapprochez votre catalogue des tâches traitées ou construisez un tableau de bord sur tout ce que vous avez transcrit.

Les transcriptions créées via l'API, de la plus récente à la plus ancienne. Pagination standard.

Crédits: Gratuit.

curl "https://api.inwista.ai/v1/transcriptions?limit=10" \
  -H "Authorization: Bearer inw_live_…"

Récupérer une transcription

À la fois le suivi de progression et le résultat final : observez le statut passer à completed, puis lisez la durée, la langue et le montant débité dans la même réponse.

Interrogez jusqu'à ce que le statut soit completed (ou enregistrez un webhook, voir plus bas). La lecture d'une transcription au statut failed déclenche aussi son remboursement automatique.

Crédits: Gratuit.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Supprimer une transcription

Supprimez un traitement à la demande — contrôle total de vos données en un seul appel.

Supprime définitivement la transcription et tout ce qui est stocké pour elle : fichiers médias, contenu de la transcription, révisions, traductions et commentaires. Les compteurs de facturation agrégés sont conservés — ils ne contiennent aucun contenu.

Seuls les traitements terminés ou échoués peuvent être supprimés ; un traitement encore en cours renvoie 409, de même qu'un traitement avec une amélioration ou une traduction en cours. La suppression est immédiate et irréversible.

Crédits: endpoints.delete-transcription.pricing

curl -X DELETE https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "deleted": true
}

Récupérer les sous-titres

Récupérez des fichiers de sous-titres prêts pour la diffusion directement dans votre lecteur, votre MAM ou votre chaîne de livraison — sans export manuel ni conversion de format de votre côté. Dans une chaîne de production vidéo, le SRT ou le VTT final arrive directement dans votre logiciel de montage, votre outil de relecture ou votre étape de packaging dès qu'un montage est transcrit.

Renvoie le corps brut du fichier de sous-titres avec le Content-Type correspondant — sans enveloppe JSON. Répond 409 not_ready tant que la transcription n'est pas terminée.

Crédits: Gratuit.

curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=srt" \
  -H "Authorization: Bearer inw_live_…" -o interview.srt

Le format json est un contrat versionné : { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — des secondes avec une précision à la milliseconde, et au sein d'une même version, des champs ne peuvent qu'être ajoutés.

Les traductions appartiennent à la version pour laquelle elles ont été créées — le revision_id de la ressource de traduction la désigne, et la version d'une amélioration ultérieure n'en hérite pas. Passez ce revision_id comme revision pour récupérer la version traduite.

Lancer une amélioration

Synchronisation et équilibrage des lignes de qualité broadcast, en pilote automatique — livrez des sous-titres qui passent le contrôle qualité sans qu'un monteur n'y touche. Pour les sociétés de production, cela automatise l'étape de conformation des sous-titres dans la chaîne de livraison : chaque épisode part avec des sous-titres cohérents et conformes aux spécifications.

Renvoie 202 avec la ressource d'amélioration.

Crédits: Calculé à partir de la taille du contenu des sous-titres, au même tarif que le studio, déduit à l'acceptation de la tâche. Remboursé automatiquement en cas d'échec.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhance \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "maxCharactersPerLine": 37, "textCondensation": "smart" } }'

{
  "id": "rev8Xk3…",
  "object": "enhancement",
  "transcription_id": "aB3dE9f2…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 12,
  "error": null,
  "created": 1754559000
}

Récupérer une amélioration

Suivi et résultat en un seul endpoint : dès que le statut indique completed, l'endpoint captions sert déjà la version améliorée.

Interrogez jusqu'au statut completed. La lecture d'une amélioration au statut failed déclenche son remboursement automatique.

Crédits: Gratuit.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhancements/rev8Xk3… \
  -H "Authorization: Bearer inw_live_…"

Lancer une traduction

Un appel par langue transforme une piste de sous-titres terminée en version localisée à la synchronisation identique — multipliez la portée de chaque vidéo que vous possédez déjà.

Renvoie 202. Répond 409 translation_exists si cette langue existe déjà pour la version courante.

Crédits: Calculé à partir de la taille du contenu des sous-titres, au même tarif que le studio, par langue cible, déduit à l'acceptation. Remboursé automatiquement en cas d'échec.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translate \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target_language": "es" }'

{
  "id": "es",
  "object": "translation",
  "transcription_id": "aB3dE9f2…",
  "target_language": "es",
  "revision_id": "TRkf2nY7…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 6,
  "error": null,
  "created": 1754559600
}

Récupérer une traduction

Suivi et résultat en un seul endpoint : une fois le statut completed atteint, récupérez le fichier de sous-titres traduit via l'endpoint captions avec le paramètre language.

Interrogez jusqu'au statut completed, puis récupérez les sous-titres traduits via l'endpoint captions avec le paramètre de requête language.

Crédits: Gratuit.

# Poll the translation resource
curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translations/es \
  -H "Authorization: Bearer inw_live_…"

# Once completed, fetch the translated subtitle file
curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=vtt&language=es" \
  -H "Authorization: Bearer inw_live_…" -o interview-es.vtt