JSON: dati strutturati per sviluppatori

Il formato JSON esporta i dati di trascrizione completi come JSON strutturato, ideale per gli sviluppatori che creano integrazioni, applicazioni personalizzate o pipeline di analisi dei dati.

Cosa contiene l'esportazione

• Metadati di trascrizione completi
• Contenuto del testo completo
• Dati segmentati con timestamp
• Informazioni sulla lingua rilevata
• Durata in secondi
• Data di creazione
• ID univoco della trascrizione
• Nome del file originale

Struttura JSON

Un'esportazione JSON ha la seguente struttura:

{
  "id": "transcription_abc123",
  "fileName": "riunione-2025-01-15.mp3",
  "text": "Testo completo della trascrizione...",
  "language": "it",
  "duration": 1825.45,
  "createdAt": "2025-01-15T10:30:00.000Z",
  "segments": [
    {
      "id": 1,
      "start": 0.0,
      "end": 5.23,
      "text": "Ciao a tutti e benvenuti..."
    },
    {
      "id": 2,
      "start": 5.23,
      "end": 9.45,
      "text": "Grazie per l'invito..."
    }
  ]
}

Descrizioni dei campi

• id - Identificatore univoco della trascrizione
• fileName: nome del file caricato originale
• text: trascrizione completa in un'unica stringa
• language: codice della lingua rilevata o selezionata (en, de, es, ecc.)
• duration: durata totale della registrazione in secondi (numero in virgola mobile)
• createdAt: data e ora di creazione in formato ISO 8601
• segments: elenco di segmenti di testo con informazioni temporali

Oggetto segmento

Ciascuna voce nell'elenco dei segmenti contiene:

• id - Numero di segmento consecutivo
• start - ora di inizio in secondi (numero in virgola mobile)
• end: ora di fine in secondi (numero in virgola mobile)
• text: contenuto testuale del segmento

Ideale per

• Integrazioni API e webhook
• Pipeline personalizzate di elaborazione dei dati
• Analisi e text mining
• Generatori di sottotitoli personalizzati
• Importazioni di database
• Dati di addestramento per il machine learning
• Indicizzazione della ricerca
• Creazione di report personalizzati

Elaborazione dei dati JSON (JavaScript)

// Carica ed elabora l'esportazione JSON
const data = JSON.parse(jsonString);

// Ottieni la durata totale in minuti
const minutes = Math.floor(data.duration / 60);

// Estrae tutto il testo
const fullText = data.text;

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

// Filtra i segmenti per intervallo di tempo
const firstMinute = data.segments.filter(
  seg => seg.start < 60
);

Elaborazione dei dati JSON (Python)

import json

# Carica il file JSON
with open('transcription.json', 'r') as f:
    data = json.load(f)

# Accedi ai campi
print(f"File: {data['fileName']}")
print(f"Durata: {data['duration']}s")
print(f"Lingua: {data['language']}")

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