원격 URL 오디오 추출 (/v1/files/fetch-url)

OneASR에는 웹 비디오 및 오디오 링크에서 16kHz 오디오를 다운로드하고 추출하는 내장 원격 미디어 추출기(yt-dlp 및 ffmpeg 기반)가 포함되어 있습니다.

---

1. 원격 추출 작업 제출

POST /v1/files/fetch-url
Authorization: Bearer sk-oneasr-...
Content-Type: application/json

{
  "url": "https://www.youtube.com/watch?v=example",
  "extract_audio": true,
  "format": "mp3"
}

응답:

{
  "task_id": "fetch_9d8e7f6a5b4c3d2e",
  "status": "downloading",
  "url": "https://www.youtube.com/watch?v=example"
}

---

2. 다운로드 진행 상황 폴링

GET /v1/files/fetch-url/fetch_9d8e7f6a5b4c3d2e
Authorization: Bearer sk-oneasr-...

응답 (완료 시):

{
  "task_id": "fetch_9d8e7f6a5b4c3d2e",
  "status": "completed",
  "file_id": "file_4a2c9b1e0f3d5a7b",
  "title": "Engineering Keynote 2026",
  "duration": 3600.0
}