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"視頻 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('上傳結果:', 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"
}
文件上傳
上傳視頻
上傳視頻獲取 URL,用於視頻生成和參考視頻輸入
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'
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"視頻 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('上傳結果:', 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"
}
文檔 Playground 不支持文件上傳:請使用下方的 cURL、Python 或 JavaScript 代碼示例進行測試。
爲什麼需要先上傳視頻?
- 統一輸入方式 - 本地視頻先上傳成公網 URL,便於後續接口複用
- 減少重複傳輸 - 上傳一次後可以在多個視頻任務中重複使用
Authorizations
string
必填
Body
file
必填
視頻文件支持的格式:
- MP4 (.mp4)
- WebM (.webm)
- MOV (.mov)
- 最大文件大小:50MB
string
上傳目的(可選)默認值:
generationResponse
boolean
請求是否成功
object
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"視頻 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('上傳結果:', 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"
}
⌘I