Veo3 비디오 생성
Generate high-quality videos using Google Veo3 model, supports async task management
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Asynchronous processing mode, returns task ID for subsequent queries
- Supports multiple generation modes including text-to-video and image-to-video
- Generated videos are retained for 30 days, download and save them before they expire
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 이미지 API first to upload images and get URLs, then call this endpoint.
Authorizations
Authorizationstring헤더필수All endpoints require Bearer Token authentication
Get your API Key from the API Key Management Page
Add to request header:
Authorization: Bearer YOUR_API_KEYBody
modelstring본문필수기본값: veo3.1-fastVideo generation model name
Available models:
veo3.1-fast- Fast generation model, suitable for quick preview and iterationveo3.1-lite- Lightweight generation model, suitable for lower-cost fast generation
Example: "veo3.1-fast"
promptstring본문필수Text description for video generation
durationinteger본문Video duration (seconds)
Fixed value: 8 (VEO3 only supports 8-second duration)
aspect_ratiostring본문Video resolution
Supported formats:
16:9(landscape)9:16(portrait)
image_urlsstring[]본문Array of reference image URLs for image-to-video generation
⚠️ URL format only (base64 no longer supported)
- Publicly accessible image URL (http:// or https://)
- You can use the Upload 이미지 API to upload local images and get URLs
Limits:
- Maximum file size: 10MB
- Supported formats: .jpeg, .jpg, .png, .webp
metadataobject본문VEO3-specific extended parameters
Show metadata fields
generation_typestring본문Video generation type
Supported types:
frame- Frame-to-video (FL mode)reference- Reference image-to-video
If not provided, automatically determined by image count: 2 images for frame mode, 3 images for reference mode
resolutionstring본문Video resolution
Supported values:
720p(default)1080p(veo3.1-liteonly)
응답
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstring모델 name used
statusstringTask status
queued- Queued for processingin_progress- Processingcompleted- Successfully completedfailed- Failed
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
요청 예시
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "veo3.1-fast",
"prompt": "Dolphins jumping in the blue ocean",
"duration": 8,
"aspect_ratio": "16:9",
"image_urls": ["https://example.com/start-frame.jpg", "https://example.com/end-frame.jpg"],
"metadata": {
"generation_type": "frame",
"resolution": "720p"
}
}'import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "veo3.1-fast",
"prompt": "Dolphins jumping in the blue ocean",
"duration": 8,
"aspect_ratio": "16:9",
"image_urls": ["https://example.com/start-frame.jpg", "https://example.com/end-frame.jpg"],
"metadata": {
"generation_type": "frame",
"resolution": "720p"
}
}
)
task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'veo3.1-fast',
prompt: 'Dolphins jumping in the blue ocean',
duration: 8,
aspect_ratio: '16:9',
image_urls: ['https://example.com/start-frame.jpg', 'https://example.com/end-frame.jpg'],
metadata: {
generation_type: 'frame',
resolution: '720p'
}
})
});
const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);응답 예시
{
"id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
"object": "generation.task",
"model": "veo3.1-fast",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {
"aspect_ratio": "16:9"
}
}