Skip to main content
POST
/
api
/
v1
/
veo
/
generate
Generate Veo3.1 Video
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"
}
'
{
  "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).
CapabilityDetails
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 RatiosSupports 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 QualityBoth 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 TrackAll 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

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