Formato JSON: datos estructurados para desarrolladores

El formato JSON exporta los datos de la transcripción de forma estructurada para integraciones, aplicaciones personalizadas y flujos de análisis de datos.

Qué obtienes

• Metadatos completos de la transcripción
• Contenido del texto completo
• Datos por segmentos con marcas de tiempo
• Información de detección de idioma
• Duración en segundos
• Fecha de creación
• ID único de la transcripción
• Nombre del archivo original

Estructura JSON

La exportación JSON sigue esta estructura:

{
  "id": "transcription_abc123",
  "fileName": "meeting-2025-01-15.mp3",
  "text": "Full transcription text...",
  "language": "en",
  "duration": 1825.45,
  "createdAt": "2025-01-15T10:30:00.000Z",
  "segments": [
    {
      "id": 1,
      "start": 0.0,
      "end": 5.23,
      "text": "Hello everyone and welcome..."
    },
    {
      "id": 2,
      "start": 5.23,
      "end": 9.45,
      "text": "Thank you for having me..."
    }
  ]
}

Descripción de los campos

• id - Identificador único de la transcripción
• fileName - Nombre original del archivo subido
• text - Transcripción completa como cadena única
• language - Código de idioma detectado/seleccionado (en, es, fr, etc.)
• duration - Duración total del audio en segundos (decimal)
• createdAt - Marca de tiempo ISO 8601 de creación
• segments - Array de segmentos de texto con tiempos

Objeto segmento

Cada segmento del array segments contiene:

• id - Número secuencial del segmento
• start - Tiempo de inicio en segundos (decimal)
• end - Tiempo de fin en segundos (decimal)
• text - Contenido de texto del segmento

Casos de uso recomendados

• Integraciones de API y webhooks
• Pipelines personalizados de procesamiento de datos
• Análisis y minería de texto
• Construcción de generadores de subtítulos personalizados
• Importaciones a bases de datos
• Datos de entrenamiento de aprendizaje automático
• Indexación de búsqueda
• Generación de informes personalizados

Procesar datos JSON (JavaScript)

// Leer y procesar la exportación JSON
const data = JSON.parse(jsonString);

// Get total duration in minutes
const minutes = Math.floor(data.duration / 60);

// Extract all text
const fullText = data.text;

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

// Filter segments by time range
const firstMinute = data.segments.filter(
  seg => seg.start < 60
);

Procesar datos JSON (Python)

import json

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

# Access fields
print(f"File: {data['fileName']}")
print(f"Duration: {data['duration']}s")
print(f"Idioma: {data['language']}")

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