Upload Video
Upload videos to get URLs for use in video generation APIs
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
The docs Playground does not support file uploads: Please use the cURL, Python, or JavaScript code examples below for testing.
Why Upload First?
- Unified input flow - Upload local videos once and reuse the returned public URL
- Less repeated transfer - The same uploaded video can be referenced by multiple generation requests
Authorizations
Authorizationstring헤더필수Use Bearer Token for authentication
Get your API Key: Visit API Key Management
Authorization: Bearer YOUR_API_KEYBody
filefile본문필수Video file
Supported formats:
- MP4 (.mp4)
- WebM (.webm)
- MOV (.mov)
Limits:
- Maximum file size: 50MB
purposestring본문Upload purpose (optional)
Default: generation
응답
successbooleanWhether the request succeeded
dataobject응답 data
idstringUpload record ID for tracking
urlstringPublic URL of the uploaded video, ready to use in video APIs
mime_typestringMIME type of the video, e.g. video/mp4
sizeintegerFile size in bytes
요청 예시
curl --request POST \
--url https://toapis.com/v1/uploads/videos \
--header 'Authorization: Bearer <token>' \
--form 'file=@/path/to/your/video.mp4'import requests
with open('video.mp4', 'rb') as f:
response = requests.post(
"https://toapis.com/v1/uploads/videos",
headers={
"Authorization": "Bearer your-ToAPIs-key"
},
files={
"file": f
}
)
result = response.json()
video_url = result['data']['url']
print(f"Video URL: {video_url}")(async () => {
const fileInput = document.createElement('input');
fileInput.type = 'file';
fileInput.accept = 'video/mp4,video/webm,video/quicktime';
fileInput.click();
await new Promise(resolve => fileInput.onchange = resolve);
const formData = new FormData();
formData.append('file', fileInput.files[0]);
const uploadResponse = await fetch('https://toapis.com/v1/uploads/videos', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key'
},
body: formData
});
const uploadResult = await uploadResponse.json();
console.log('Upload result:', uploadResult);
})();응답 예시
{
"success": true,
"message": "",
"data": {
"id": "upload_abc12345",
"url": "https://files.toapis.com/uploads/123/videos/1737568800_abc12345.mp4",
"mime_type": "video/mp4",
"size": 1892345
}
}{
"success": false,
"message": "Unsupported or invalid video file. Allowed: MP4, WebM, MOV"
}{
"success": false,
"message": "Video too large. Maximum size is 50MB"
}