Generate Veo3.1 Video
POST
/api/v1/veo/generate
| 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.
2.
3.
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/veo/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"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"
}'Response Response Example
200 - Example of Success
{
"code": 200,
"msg": "success",
"data": {
"taskId": "veo_task_abcdef123456"
}
}