Generate Veo 3.1 AI Video(Fast&Quality)

Create a new video generation task using the Veo3.1 AI model.

POST /api/v1/veo/generate

Generate Veo3.1 Video

cURL

curl --request POST \
  --url https://api.kie.ai/api/v1/veo/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A dog playing in a park",
  "imageUrls": [
    "http://example.com/image1.jpg",
    "http://example.com/image2.jpg"
  ],
  "model": "veo3_fast",
  "watermark": "MyBrand",
  "callBackUrl": "http://your-callback-url.com/complete",
  "aspect_ratio": "16:9",
  "seeds": 12345,
  "enableFallback": false,
  "enableTranslation": true,
  "generationType": "REFERENCE_2_VIDEO"
}
'

200

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}

Create a new video generation task using the Veo 3.1 API.

Our Veo 3.1 Generation API is more than a direct wrapper around Google’s baseline. It layers extensive optimisation and reliability tooling on top of the official models, giving you greater flexibility and markedly higher success rates — 25% of the official Google pricing (see kie.ai/pricing for full details).

Capability	Details
Models	• Veo 3.1 Quality — flagship model, highest fidelity • Veo 3.1 Fast — cost-efficient variant that still delivers strong visual results
Tasks	• Text → Video • Image → Video (single reference frame or first and last frames) • Material → Video (based on material images)
Generation Modes	• TEXT_2_VIDEO — Text-to-video: using text prompts only • FIRST_AND_LAST_FRAMES_2_VIDEO — First and last frames to video: generate transition videos using one or two images • REFERENCE_2_VIDEO — Material-to-video: based on material images (Fast model only, supports 16:9 & 9:16)
Aspect Ratios	Supports both native 16:9 and 9:16 outputs. Auto mode lets the system decide aspect ratio based on input materials and internal strategy (for production control, we recommend explicitly setting aspect_ratio).
Output Quality	Both 16:9 and 9:16 support 1080P and 4K outputs. 4K requires extra credits (approximately 2× the credits of generating a Fast mode video) and is requested via a separate 4K endpoint.
Audio Track	All videos ship with background audio by default. In rare cases, upstream may suppress audio when the scene is deemed sensitive (e.g. minors).

Why our Veo 3.1 API is different

1. True vertical video – Native Veo 3.1 supports 9:16 output, delivering authentic vertical videos without the need for re-framing or manual editing.
2. Global language reach – Our flow supports multilingual prompts by default (no extra configuration required).
3. Significant cost savings – Our rates are 25% of Google’s direct API pricing.

Authorizations

Authorization · string · header · required

All APIs require authentication via Bearer Token.

Get API Key:

1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Body

application/json

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

Example:

"A dog playing in a park"

imageUrls · string[]

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.

Example:

[
  "http://example.com/image1.jpg",
  "http://example.com/image2.jpg"
]

model · enum<string> · default: veo3_fast

Select the model type to use.

• veo3: Veo 3.1 Quality, supports both text-to-video and image-to-video generation
• veo3_fast: Veo3.1 Fast generation model, supports both text-to-video and image-to-video generation

Available options: veo3, veo3_fast

Example:

"veo3_fast"

generationType · enum<string>

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_VIDEO mode currently only supports veo3_fast model and 16:9 aspect ratio
• If not specified, the system will automatically determine the generation mode based on whether imageUrls are provided

Available options: TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO

Example:

"TEXT_2_VIDEO"

aspect_ratio · enum<string> · default: 16:9

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.

Available options: 16:9, 9:16, Auto

Example:

"16:9"

seeds · integer

(Optional) Random seed parameter to control the randomness of the generated content. Value range: 10000-99999. The same seed will generate similar video content, different seeds will generate different content. If not provided, the system will assign one automatically.

Required range: 10000 <= x <= 99999

Example:

12345

callBackUrl · string

Completion callback URL for receiving video generation status updates.

• Optional but recommended for production use
• System will POST task completion status to this URL when the video generation is completed
• Callback will include task results, video URLs, and status information
• Your callback endpoint should accept POST requests with JSON payload
• For detailed callback format and implementation guide, see Callback Documentation
• To ensure callback security, see Webhook Verification Guide for signature verification implementation
• Alternatively, use the Get Video Details endpoint to poll task status

Example:

"http://your-callback-url.com/complete"

enableFallback · boolean · default: false · deprecated

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: Videos generated through fallback mode cannot be accessed via the Get 1080P Video endpoint
• Credit Consumption: Successful fallback has different credit consumption, please see https://kie.ai/pricing for pricing details

Note: This parameter is deprecated. Please remove this parameter from your requests. The system has automatically optimized the content review mechanism without requiring manual fallback configuration.

Example:

false

enableTranslation · boolean · default: true

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

Example:

true

watermark · string

Watermark text.

• Optional parameter
• If provided, a watermark will be added to the generated video

Example:

"MyBrand"

Response

200

application/json

Request successful

code · enum<integer>

Response status code

• 200: Success - Request has been processed successfully
• 400: 1080P is processing. It should be ready in 1-2 minutes. Please check back shortly.
• 401: Unauthorized - Authentication credentials are missing or invalid
• 402: Insufficient Credits - Account does not have enough credits to perform the operation
• 404: Not Found - The requested resource or endpoint does not exist
• 422: Validation Error - Request parameters failed validation. When fallback is not enabled and generation fails, error message format: Your request was rejected by Flow(original error message). You may consider using our other fallback channels, which are likely to succeed. Please refer to the documentation.
• 429: Rate Limited - Request limit has been exceeded for this resource
• 455: Service Unavailable - System is currently undergoing maintenance
• 500: Server Error - An unexpected error occurred while processing the request
• 501: Generation Failed - Video generation task failed
• 505: Feature Disabled - The requested feature is currently disabled

Available options: 200, 400, 401, 402, 404, 422, 429, 455, 500, 501, 505

msg · string

Error message when code != 200

Example:

"success"

data · object

Show child attributes