File Upload & Storage API (/v1/files)

Manage stored audio and video files on the OneASR server storage before submitting batch transcription tasks.

---

1. Upload File (POST /v1/files/upload)

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

Response:

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

---

2. List Files (GET /v1/files/list)

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

---

3. Delete File (DELETE /v1/files/{file_id})

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