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",
  "aspectRatio": "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 Veo3.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/billing 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 two images
• REFERENCE_2_VIDEO — Material-to-video: based on material images (only supports Fast model and 16:9 aspect ratio)
Aspect RatiosWe now support both native 16:9 and 9:16 outputs, allowing you to generate horizontal or vertical videos without any extra processing. In addition, the Auto mode automatically matches the aspect ratio based on the uploaded image.
LanguagesGoogle’s native support is English‑only; our multilingual prompt pre‑processing extends reliable generation to most major languages.
Audio TrackAll videos ship with background audio by default. In < 5 % of cases Google suppresses 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 now fully supports 9:16 output, delivering authentic vertical videos without the need for re-framing or manual editing.
  2. Global language reach – Prompt sanitisation, token‑weight rebalancing lift non‑English success rates far above stock Veo 3.1 behaviour.
  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"

​
aspectRatio
enum<string>
default:16:9

Video aspect ratio. Specifies the dimension ratio of the generated video. Available options:

  • 16:9: Landscape video format, supports 1080P HD video generation (Only 16:9 aspect ratio supports 1080P)
  • 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
  • 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/billing for billing 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