Video models › Veo3.1
Generate Veo3.1 Video
Generate Veo3.1 Video
video Veo3.1 78 tokens per video $0.005 per token
Pricing
| Option | Tokens | Unit | ≈ USD |
|---|---|---|---|
| reference-to-video, Lite-720p | 39 | per video | $0.1950 |
| text-to-video, Lite-720p | 39 | per video | $0.1950 |
| image-to-video, Lite-720p | 39 | per video | $0.1950 |
| reference-to-video, Lite-1080p | 46 | per video | $0.2300 |
| text-to-video, Lite-1080p | 46 | per video | $0.2300 |
| image-to-video, Lite-1080p | 46 | per video | $0.2300 |
| text-to-video, Fast-720p | 78 | per video | $0.3900 |
| image-to-video, Fast-720p | 78 | per video | $0.3900 |
| reference-to-video, Fast-720p | 78 | per video | $0.3900 |
| reference-to-video, Fast-1080p | 85 | per video | $0.4250 |
| text-to-video, Fast-1080p | 85 | per video | $0.4250 |
| image-to-video, Fast-1080p | 85 | per video | $0.4250 |
| reference-to-video, Lite-4k | 195 | per video | $0.9750 |
| text-to-video, Lite-4K | 195 | per video | $0.9750 |
| image-to-video, Lite-4K | 195 | per video | $0.9750 |
| reference-to-video, Fast-4k | 234 | per video | $1.1700 |
| text-to-video, Fast-4K | 234 | per video | $1.1700 |
| image-to-video, Fast-4K | 234 | per video | $1.1700 |
| text-to-video, Quality-720p | 325 | per video | $1.6250 |
| image-to-video, Quality-720p | 325 | per video | $1.6250 |
| text-to-video, Quality-1080p | 332 | per video | $1.6600 |
| image-to-video, Quality-1080p | 332 | per video | $1.6600 |
| image-to-video, Quality-4K | 481 | per video | $2.4050 |
| text-to-video, Quality-4K | 494 | per video | $2.4700 |
The price is held when the task is created and settled to actual consumption when it completes; a failed task releases the hold.
How to order
Clips are ordered for a video session of the project; the model id goes into the order and must be one of the project's GET /projects/{id}/video-models.
POST https://app.video-blade.com/api/v1/projects/{id}/video-sessions/{item_id}/generate
X-API-Key: vb_…
Content-Type: application/json
{"prompt": "…", "model": "veo3-generate-veo-3-video", "duration": …, "start_url": "https://…"}
→ 202 {"generation_id": "…", "status": "running", "tokens": …}Field lists and refusal codes — API reference.
Model parameters
What the model itself understands; the ordering calls above take their own fields and pass these on.
| Name | Type | Required | Description |
|---|---|---|---|
prompt |
string | required | Text prompt describing the desired video content. Required for all generation modes. - Should be detailed and specific in describing video content - Can include actions, scenes, style and other information - For image-to-video, describe how you want the image to come alive |
image_urls |
array | optional | Image URL list (used in image-to-video mode). Supports 1 or 2 images: - **1 image**: The generated video will unfold around this image, with the image content presented dynamically - **2 images**: The first image serves as the video's first frame, and the second image serves as the video's last frame, with the video transitioning between them - Must be valid image URLs - Images must be accessible to the API server. |
generation_type |
string | optional | Video generation mode (optional). Specifies different video generation approaches: - **TEXT_2_VIDEO**: Text-to-video - Generate videos using only text prompts - **FIRST_AND_LAST_FRAMES_2_VIDEO**: First and last frames to video - Flexible image-to-video generation mode - 1 image: Generate video based on the provided image - 2 images: First image as first frame, second image as last frame, generating transition video - **REFERENCE_2_VIDEO**: Reference-to-video - Generate videos based on reference images, requires 1-3 images in imageUrls (minimum 1, maximum 3) **Important Notes**: - REFERENCE_2_V Values:
TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO |
aspect_ratio |
string | optional | Video aspect ratio. Specifies the dimension ratio of the generated video. Available options: - 16:9: Landscape video format. - 9:16: Portrait video format, suitable for mobile short videos - Auto: In auto mode, the video will be automatically center-cropped based on whether your uploaded image is closer to 16:9 or 9:16. Default value is 16:9. Values: 16:9, 9:16, AutoDefault:
16:9 |
enable_fallback |
boolean | optional | Deprecated Enable fallback functionality. When set to true, if the official Veo3.1 video generation service is unavailable or encounters exceptions, the system will automatically switch to a backup model for video generation to ensure task continuity and reliability. Default value is false. - When fallback is enabled, backup model will be used for the following errors: - public error minor upload - Your prompt was flagged by Website as violating content policies - public error prominent people upload - Fallback mode requires 16:9 aspect ratio and uses 1080p resolution by default - **Note**: Vi Default:
False |
enable_translation |
boolean | optional | Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results. Default value is true. - true: Enable translation, prompts will be automatically translated to English - false: Disable translation, use original prompts directly for generation Default:
False |
watermark |
string | optional | Watermark text. - Optional parameter - If provided, a watermark will be added to the generated video |
resolution |
string | optional | Controls the pixel dimensions of the generated image. Higher resolution results in greater clarity and detail, while lower resolution allows for faster generation. Values: 720p, 1080p, 4kDefault:
720p |
duration |
integer | optional | The duration of the generated video, in seconds. Optional values are 4, 6, 8. **Important Note**: - The REFERENCE_2_VIDEO mode currently only supports a duration of 8 seconds. Values: 4, 6, 8Default:
8 |