跳轉到主要內容
POST
/
v1
/
uploads
/
videos
curl --request POST \
  --url https://toapis.com/v1/uploads/videos \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@/path/to/your/video.mp4'

{
  "success": true,
  "message": "",
  "data": {
    "id": "upload_abc12345",
    "url": "https://files.toapis.com/uploads/123/videos/1737568800_abc12345.mp4",
    "mime_type": "video/mp4",
    "size": 1892345
  }
}
文檔 Playground 不支持文件上傳：請使用下方的 cURL、Python 或 JavaScript 代碼示例進行測試。

​
爲什麼需要先上傳視頻？

  1. 統一輸入方式 - 本地視頻先上傳成公網 URL，便於後續接口複用
  2. 減少重複傳輸 - 上傳一次後可以在多個視頻任務中重複使用

​
Authorizations

​
Authorization
string
必填
使用 Bearer Token 進行認證獲取 API Key：訪問 API Key 管理頁面
Authorization: Bearer YOUR_API_KEY

​
Body

​
file
file
必填
視頻文件支持的格式：
  • MP4 (.mp4)
  • WebM (.webm)
  • MOV (.mov)
限制：
  • 最大文件大小：50MB
​
purpose
string
上傳目的（可選）默認值：generation

​
Response

​
success
boolean
請求是否成功
​
data
object
curl --request POST \
  --url https://toapis.com/v1/uploads/videos \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@/path/to/your/video.mp4'

{
  "success": true,
  "message": "",
  "data": {
    "id": "upload_abc12345",
    "url": "https://files.toapis.com/uploads/123/videos/1737568800_abc12345.mp4",
    "mime_type": "video/mp4",
    "size": 1892345
  }
}