YouTube 視頻批量下載 API

/download/create/batch API 端點允許您為多個 YouTube 視頻創建批量下載任務。

API 詳情

端點 POST https://dlapi.abcproxy.com/download/create/batch

描述

此 API 會為指定影片 ID 的多個 YouTube 影片創建批次下載作業。下載的影片將存儲在指定的雲存儲中，並在完成後向提供的 URL 發送回調。

---

請求

HTTP 請求

---

cURL

curl -X POST "https://dlapi.abcproxy.com/download/create/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "video_ids": ["9cQBNYsCqQs", "KGOsWPF4Wfs"],
    "proxy_api_key": "xxxxx",
    "storage_type": "oss",
    "storage_url": "https://ACCESS_KEY:[e-mail]/your-bucket/your-folder",
    "callback_url": "https://your-callback-url.com"
  }'

Python

import requests

payload = {
    "video_ids": ["9cQBNYsCqQs", "KGOsWPF4Wfs"],
    "proxy_api_key": "xxxxx",
    "storage_type": "oss",
    "storage_url": "https://ACCESS_KEY:[e-mail]/your-bucket/your-folder",
    "callback_url": "https://your-callback-url.com"
}
response = requests.post("https://dlapi.abcproxy.com/download/create/batch", json=payload)
print(response.json())

Node.js

const axios = require('axios');

const payload = {
  "video_ids": ["9cQBNYsCqQs", "KGOsWPF4Wfs"],
  "proxy_api_key": "xxxxx",
  "storage_type": "oss",
  "storage_url": "https://ACCESS_KEY:[e-mail]/your-bucket/your-folder",
  "callback_url": "https://your-callback-url.com"
};

axios.post("https://dlapi.abcproxy.com/download/create/batch", payload)
  .then(response => console.log(response.data));

HTTP

POST /download/create/batch HTTP/1.1
Host: localhost:8080
Content-Type: application/json

{
  "video_ids": ["9cQBNYsCqQs", "KGOsWPF4Wfs"],
  "proxy_api_key": "xxxxx",
  "storage_type": "oss",
  "storage_url": "https://ACCESS_KEY:[e-mail]/your-bucket/your-folder"
}

參數

請求主體

名稱	類型	必填	描述	示例
video_ids	字符串數組	是	要下載的 YouTube 影片 ID 列表	["9cQBNYsCqQs", "KGOsWPF4Wfs"]
proxy_api_key	字符串	是	用於身份驗證的代理 API 密鑰	"xxxxx"
storage_type	字符串	是	對象存儲類型 (default, minio, oss, s3_compatible)	"oss"
storage_url	字符串	是	包含憑據的雲存儲 URL	"https://ACCESS_KEY:[e-mail]/your-bucket/your-folder"

---

回應

成功 200

回應主體

{
  "code": 200,
  "msg": "成功",
  "data": {
    "batch_id": "25ba9534-bb83-4496-ac5b-6bc94f83e963"
  }
}

回應字段

字段	類型	描述
code	數值	回應代碼 (200 表示成功)
msg	字符串	回應消息
data.batch_id	字符串	批次下載作業的唯一 ID

---

錯誤回應

常見錯誤

HTTP 狀態	錯誤代碼	描述
400	缺少必填參數	一個或多個必填參數缺失
401	無效的代理 API 密鑰	提供的代理 API 密鑰無效
500	內部服務器錯誤	處理請求時發生錯誤

錯誤示例

{
  "code": 400,
  "msg": "缺少必填參數: video_ids",
  "data": null
}

---

注意事項

1. storage_type 參數接受以下值：

   • default: 默認存儲

   • minio: Minio 對象存儲

   • oss: 阿裡雲 OSS

   • s3_compatible: 兼容 S3 的存儲

2. storage_url 應包含格式如下的身份驗證憑據： https://ACCESS_KEY:SECRET_KEY@storage-endpoint/bucket-name/path

3. 批次作業完成時，回調 URL 將收到一個 POST 請求，其中包含作業狀態和詳細信息。