非同期大容量ファイル文字起こしタスク API

数時間に及ぶ長時間の録音ファイル（会議、授業、映画など）には、非同期バッチ処理タスク API の利用を推奨します。

---

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：（任意）話者分離（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-...