Formato JSON: dados estruturados para desenvolvedores

O formato JSON exporta todos os dados da transcrição em uma estrutura organizada, ideal para desenvolvedores que criam integrações, aplicativos personalizados ou fluxos de análise de dados.

O que está incluído

• Metadados completos da transcrição
• Texto completo
• Dados divididos em segmentos com marcações de tempo
• Informações de detecção de idioma
• Duração em segundos
• Data de criação
• ID único da transcrição
• Nome original do arquivo

Estrutura do JSON

A exportação JSON segue esta estrutura:

{
  "id": "transcription_abc123",
  "fileName": "meeting-2025-01-15.mp3",
  "text": "Texto completo da transcrição...",
  "language": "pt",
  "duration": 1825.45,
  "createdAt": "2025-01-15T10:30:00.000Z",
  "segments": [
    {
      "id": 1,
      "start": 0.0,
      "end": 5.23,
      "text": "Olá, pessoal! Boas-vindas..."
    },
    {
      "id": 2,
      "start": 5.23,
      "end": 9.45,
      "text": "Obrigado pelo convite..."
    }
  ]
}

Descrição dos campos

• id: identificador único da transcrição
• fileName: nome original do arquivo enviado
• text: transcrição completa em uma única string
• language: código do idioma detectado ou selecionado, como en, es ou fr
• duration: duração total do áudio em segundos, com casas decimais
• createdAt: data e hora de criação no padrão ISO 8601
• segments: lista de segmentos de texto com marcações de tempo

Objeto de segmento

Cada segmento da lista segments contém:

• id: número sequencial do segmento
• start: tempo de início em segundos, com casas decimais
• end: tempo de fim em segundos, com casas decimais
• text: texto do segmento

Quando usar

• Integrações via API e webhooks
• Fluxos personalizados de processamento de dados
• Análise e mineração de texto
• Criação de geradores de legendas personalizados
• Importação para bancos de dados
• Dados de treinamento para aprendizado de máquina
• Indexação para busca
• Geração de relatórios personalizados

Processar dados JSON em JavaScript

// Ler e processar a exportação JSON
const data = JSON.parse(jsonString);

// Obter a duração total em minutos
const minutes = Math.floor(data.duration / 60);

// Extrair o texto completo
const fullText = data.text;

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

// Filtrar os segmentos por intervalo de tempo
const firstMinute = data.segments.filter(
  seg => seg.start < 60
);

Processar dados JSON em Python

import json

# Carregar o arquivo JSON
with open('transcription.json', 'r') as f:
    data = json.load(f)

# Acessar os campos
print(f"Arquivo: {data['fileName']}")
print(f"Duração: {data['duration']}s")
print(f"Idioma: {data['language']}")

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