跳转到主要内容
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
  }
}