ファイルアップロード & ストレージ管理 API (/v1/files)

バッチ文字起こしタスクを開始する前に、OneASR サーバーに一時保存されている音声ファイルを管理します。

---

1. 音声ファイルのアップロード (POST /v1/files/upload)

POST /v1/files/upload
Authorization: Bearer sk-oneasr-...
Content-Type: multipart/form-data

レスポンスボディ：

{
  "file_id": "file_4a2c9b1e0f3d5a7b",
  "filename": "interview.mp3",
  "size_bytes": 14502300,
  "duration_seconds": 1820.5,
  "created_at": "2026-09-28T15:00:00Z"
}

---

2. ファイル一覧の取得 (GET /v1/files/list)

GET /v1/files/list?limit=20&offset=0
Authorization: Bearer sk-oneasr-...

---

3. ファイルの削除 (DELETE /v1/files/{file_id})

DELETE /v1/files/file_4a2c9b1e0f3d5a7b
Authorization: Bearer sk-oneasr-...