Skip to content

網路影音擷取介面 (/v1/files/fetch-url) ​

OneASR 內建基於 yt-dlp 與 ffmpeg 的串流媒體擷取引擎,可直接將網頁影片轉換為標準化音訊。


1. 提交擷取任務 ​

http
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"
}

回應主體: ​

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

2. 輪詢擷取進度 ​

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

回應主體(擷取完成): ​

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