Generate Veo3.1 Video

video Veo3.1 price on request

Request

POST https://app.video-blade.com/api/v1/generations
X-API-Key: vb_…
Content-Type: application/json

{
  "callback_url": "https://your-app.example/callbacks/video-blade",
  "input": {
    "prompt": "\u2026"
  },
  "model": "veo3-generate-veo-3-video"
}

Input parameters

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`, `Auto` Default: `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`, `4k` Default: `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`, `8` Default: `8`

Pricing

Price on request; the charge is settled from actual consumption with the video coefficient ×2.0. See Pricing & tokens.