Перейти к основному содержанию
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. Повторное использование - один и тот же URL можно использовать в нескольких задачах генерации

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