JSON 格式：面向開發者的結構化資料

JSON 將轉錄結果儲存為結構化資料，適合系統整合、自訂應用程式和資料分析流程。

匯出內容

• 完整的轉錄檔案資訊
• 全文內容
• 帶時間戳記的分段資料
• 語言辨識資訊
• 以秒為單位的時長
• 建立日期
• 轉錄記錄的唯一 ID
• 原始檔案名

JSON 結構

JSON 匯出的結構示例如下：

{
  "id": "transcription_abc123",
  "fileName": "會議-2025-01-15.mp3",
  "text": "完整逐字稿……",
  "language": "zh",
  "duration": 1825.45,
  "createdAt": "2025-01-15T10:30:00.000Z",
  "segments": [
    {
      "id": 1,
      "start": 0.0,
      "end": 5.23,
      "text": "大家好，歡迎……"
    },
    {
      "id": 2,
      "start": 5.23,
      "end": 9.45,
      "text": "謝謝邀請……"
    }
  ]
}

字段說明

• id：轉錄記錄的唯一標識符
• fileName：原始上傳檔案名
• text：以單個字元串表示的完整逐字稿
• language：辨識或選擇的語言代碼，例如 en、es、fr
• duration：音訊總時長，以秒為單位，可包含小數
• createdAt：ISO 8601 格式的建立時間
• segments：帶時間資訊的文字分段數組

分段對象

segments 數組中的每個分段包含：

• id：分段序號
• start：開始時間，以秒為單位，可包含小數
• end：結束時間，以秒為單位，可包含小數
• text：該分段的文字

適用場景

• API 和 Webhook 整合
• 自訂資料處理流程
• 分析和文字挖掘
• 開發字幕生成工具
• 匯入資料庫
• 準備機器學習訓練資料
• 建立搜尋索引
• 生成自訂報告

使用 JavaScript 處理 JSON

// 讀取並處理匯出的 JSON
const data = JSON.parse(jsonString);

// 取得總時長，單位為分鐘
const minutes = Math.floor(data.duration / 60);

// 取得全文
const fullText = data.text;

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

// 按時間範圍篩選分段
const firstMinute = data.segments.filter(
  seg => seg.start < 60
);

使用 Python 處理 JSON

import json

# 加載 JSON 檔案
with open('transcription.json', 'r') as f:
    data = json.load(f)

# 讀取字段
print(f"檔案： {data['fileName']}")
print(f"時長： {data['duration']}s")
print(f"語言： {data['language']}")

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