Veo3.1-Fast Video Generation Beta
- Veo 3.1 Fast (veo-3.1-fast) model supports text-to-video, first-frame image-to-video and other modes
- Asynchronous processing mode, use the returned task ID to query
- Generated video links are valid for 24 hours, please save them promptly
Authorizations
##All APIs require Bearer Token authentication##
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Body
Video generation model name
Backward Compatible: The previously integrated model name veo3.1-fast is still supported and will be automatically mapped to veo3.1-fast-beta
veo3.1-fast-beta "veo3.1-fast-beta"
Prompt describing what kind of video to generate, limited to 2000 tokens
2000"A cat playing piano"
Video aspect ratio. When set to auto: image-to-video will automatically select based on the input image ratio, text-to-video will automatically select based on the prompt content
auto, 16:9, 9:16 "auto"
Reference image URL list for image-to-video feature
Note:
- Single request supports input image quantity:
3images (1 image for first-frame video generation, 2 images for first-and-last-frame video generation) - Image size: no more than
10MB - Supported file formats:
.jpg,.jpeg,.png,.webp - Image URLs must be directly viewable by the server, or the image URL should trigger direct download when accessed (typically these URLs end with image file extensions, such as
.png,.jpg)
3Video resolution, default is 720p
720p Video generation mode, default matches based on image count, manual selection recommended. Available modes:
TEXT: Text to videoFIRST&LAST: First and last frame to video, supports1~2imagesREFERENCE: Reference image to video, supports up to3images
Note:
- Currently, the reference image to video
REFERENCEmode only supports16:9aspect ratio
TEXT, FIRST&LAST, REFERENCE Whether to automatically translate the prompt to English. When enabled, non-English prompts will be automatically translated to English for better generation results
true
HTTPS callback address after task completion
Callback Timing:
- Triggered when task is completed, failed, or cancelled
- Sent after billing confirmation is completed
Security Restrictions:
- Only HTTPS protocol is supported
- Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback Mechanism:
- Timeout:
10seconds - Maximum
3retries on failure (retries after1second/2seconds/4seconds) - Callback response body format is consistent with the task query API response format
- Callback address returning 2xx status code is considered successful, other status codes will trigger retry
"https://your-domain.com/webhooks/video-task-completed"
Response
Video generation task created successfully
Task creation timestamp
1757169743
Task ID
"task-unified-1757169743-7cvnl5zw"
Actual model name used
"veo3.1-fast-beta"
Specific task type
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Video task detailed information
Task output type
text, image, audio, video "video"
Usage and billing information