비동기 파일 전사 API

긴 파일(예: 2시간 분량의 회의 녹음, 팟캐스트, 영화 비디오 트랙)의 경우 OneASR의 비동기 작업 API를 사용하세요.

---

1. 전사 작업 생성 (POST /v1/file-transcription/transcriptions)

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

폼 매개변수:

• file: 오디오/비디오 바이너리 객체 (mp3, wav, mp4, mkv 등 최대 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": "Full transcribed speech text...",
    "srt": "1\n00:00:00,000 --> 00:00:04,500\nFull transcribed speech text...\n",
    "vtt": "WEBVTT\n\n00:00:00.000 --> 00:00:04.500\nFull transcribed speech text...\n"
  }
}

---

3. 작업 취소 (DELETE /v1/file-transcription/transcriptions/{task_id})

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