Format JSON : données structurées pour les développeurs

Le format JSON exporte les données complètes de la transcription sous forme de JSON structuré, parfait pour les développeurs qui construisent des intégrations, des applications personnalisées ou des pipelines d'analyse de données.

Ce que vous obtenez

• Métadonnées complètes de la transcription
• Contenu textuel complet
• Données segmentées avec horodatages
• Informations de détection de la langue
• Durée en secondes
• Date de création
• Identifiant unique de la transcription
• Nom de fichier original

Structure du JSON

L'export JSON suit cette structure :

{
  "id": "transcription_abc123",
  "fileName": "meeting-2025-01-15.mp3",
  "text": "Texte complet de la transcription...",
  "language": "fr",
  "duration": 1825.45,
  "createdAt": "2025-01-15T10:30:00.000Z",
  "segments": [
    {
      "id": 1,
      "start": 0.0,
      "end": 5.23,
      "text": "Bonjour à tous et bienvenue..."
    },
    {
      "id": 2,
      "start": 5.23,
      "end": 9.45,
      "text": "Merci de m'accueillir..."
    }
  ]
}

Description des champs

• id — identifiant unique de la transcription
• fileName — nom du fichier d'origine téléversé
• text — transcription complète sous forme de chaîne unique
• language — code de la langue détectée/sélectionnée (en, es, fr, etc.)
• duration — durée totale de l'audio en secondes (flottant)
• createdAt — horodatage ISO 8601 de la création
• segments — tableau de segments textuels minutés

Objet segment

Chaque segment du tableau segments contient :

• id — numéro séquentiel du segment
• start — temps de début en secondes (flottant)
• end — temps de fin en secondes (flottant)
• text — contenu textuel du segment

Meilleurs cas d'usage

• Intégrations d'API et webhooks
• Pipelines de traitement de données personnalisés
• Analytique et fouille de texte
• Création de générateurs de sous-titres personnalisés
• Imports en base de données
• Données d'entraînement pour apprentissage automatique
• Indexation de recherche
• Génération de rapports personnalisés

Traiter les données JSON (JavaScript)

// Lire et traiter l'export JSON
const data = JSON.parse(jsonString);

// Obtenir la durée totale en minutes
const minutes = Math.floor(data.duration / 60);

// Extraire tout le texte
const fullText = data.text;

// Traiter les segments
data.segments.forEach(segment => {
  console.log(`[${segment.start}s] ${segment.text}`);
});

// Filtrer les segments par plage de temps
const firstMinute = data.segments.filter(
  seg => seg.start < 60
);

Traiter les données JSON (Python)

import json

# Charger le fichier JSON
with open('transcription.json', 'r') as f:
    data = json.load(f)

# Accéder aux champs
print(f"Fichier : {data['fileName']}")
print(f"Durée : {data['duration']}s")
print(f"Langue : {data['language']}")

# Traiter les segments
for segment in data['segments']:
    print(f"[{segment['start']:.2f}s] {segment['text']}")