Veo3.1 API Quickstart

Get started with Veo3.1 API in 5 minutes

Welcome to Veo3.1 API! This guide will help you quickly get started with our high-quality AI video generation service.

Overview

Veo3.1 API is a powerful AI video generation platform that supports:

Text-to-Video

Generate high-quality videos through descriptive text prompts

Image-to-Video

Bring static images to life, creating engaging videos

HD Support

Support for generating 1080P high-definition videos (16:9 aspect ratio)

Real-time Callbacks

Automatically push results to your server when tasks complete

Step 1: Get Your API Key

Visit API Key Management Page

Generate a new API Key

Safely store your API Key

Please keep your API Key secure and do not expose it in public code repositories. If you suspect it has been compromised, reset it immediately.

Step 2: Basic Authentication

All API requests need to include your API Key in the request headers:

API Base URL: https://api.kie.ai

Step 3: Your First Video Generation

Text-to-Video Example

Node.js

Python

cURL

Image-to-Video Example

Node.js

Python

cURL

Step 4: Check Task Status

Video generation typically takes a few minutes. You can get results through polling or callbacks.

Polling Method

Node.js

Python

cURL

Status Descriptions

successFlag	Description
0	Generating - Task is currently being processed
1	Success - Task completed successfully
2	Failed - Task generation failed
3	Generation Failed - Task created successfully but generation failed

Step 5: Get HD Video (Optional)

If you use 16:9 aspect ratio to generate videos, you can get the 1080P high-definition version:

Node.js

Python

cURL

Note: 1080P video requires additional processing time. It's recommended to wait a few minutes after the original video generation is completed before calling this endpoint.

Callback Handling (Recommended)

Compared to polling, callback mechanism is more efficient. Set the callBackUrl parameter, and the system will automatically push results when tasks complete:

Node.js (Express)

Python (Flask)

Complete Example: From Generation to Download

Node.js Complete Workflow

Best Practices

Optimize Prompts

Use detailed and specific descriptions

Include actions, scenes, and style information

Avoid vague or contradictory descriptions

Choose Models Wisely

veo3: Quality model, higher quality

veo3_fast: Fast model, quicker generation

Handle Exceptions

Implement retry mechanisms

Handle network and API errors

Log errors for debugging

Resource Management

Download and save videos promptly

Control concurrent request numbers reasonably

Monitor API usage quotas

Frequently Asked Questions

How long does generation take?

What image formats are supported?

How to get better video quality?

Do video URLs have expiry dates?

How to handle generation failures?

How to generate a Veo 3.1 video longer than 8 seconds?

Next Steps

API Reference

View complete API parameters and response formats

Callback Handling

Learn how to handle task completion callbacks

Get Details

Learn how to query task status and results

If you encounter any issues during usage, please contact our technical support: support@kie.ai

Veo3.1 API Quickstart

Overview#

Step 1: Get Your API Key#

Step 2: Basic Authentication#

Step 3: Your First Video Generation#

Text-to-Video Example#

Image-to-Video Example#

Step 4: Check Task Status#

Polling Method#

Status Descriptions#

Step 5: Get HD Video (Optional)#

Callback Handling (Recommended)#

Complete Example: From Generation to Download#

Best Practices#

Frequently Asked Questions#

Next Steps#

Overview

Step 1: Get Your API Key

Step 2: Basic Authentication

Step 3: Your First Video Generation

Text-to-Video Example

Image-to-Video Example

Step 4: Check Task Status

Polling Method

Status Descriptions

Step 5: Get HD Video (Optional)

Callback Handling (Recommended)

Complete Example: From Generation to Download

Best Practices

Frequently Asked Questions

Next Steps