非同步大檔案轉錄任務介面

對於長時間錄音檔案（如數小時的會議、課程或電影），建議使用非同步批次處理任務介面。

---

1. 提交轉錄任務 (POST /v1/file-transcription/transcriptions)

POST /v1/file-transcription/transcriptions
Authorization: Bearer sk-oneasr-...
Content-Type: multipart/form-data

表單參數：

• file：影音檔案二進位物件（最大支援 2GB）。
• model：目標 ASR 模型名稱（faster-whisper, qwen, firered）。
• language：（選填）ISO-639-1 語言代碼。
• enable_diarization：（選填）是否啟用說話者分離 (true / false)。

回應主體：

{
  "task_id": "task_8f9c1e7a2b3c4d5e",
  "status": "queued",
  "created_at": "2026-09-28T15:00:00Z"
}

---

2. 輪詢任務狀態 (GET /v1/file-transcription/transcriptions/{task_id})

GET /v1/file-transcription/transcriptions/task_8f9c1e7a2b3c4d5e
Authorization: Bearer sk-oneasr-...

回應主體（轉錄完成）：

{
  "task_id": "task_8f9c1e7a2b3c4d5e",
  "status": "completed",
  "progress": 1.0,
  "result": {
    "text": "完整轉錄文字內容...",
    "srt": "1\n00:00:00,000 --> 00:00:04,500\n完整轉錄文字內容...\n",
    "vtt": "WEBVTT\n\n00:00:00.000 --> 00:00:04.500\n完整轉錄文字內容...\n"
  }
}

---

3. 取消任務 (DELETE /v1/file-transcription/transcriptions/{task_id})

DELETE /v1/file-transcription/transcriptions/task_8f9c1e7a2b3c4d5e
Authorization: Bearer sk-oneasr-...