Skip to main content
POST
/
v1
/
videos
/
generations
kling-v3-fast Video Generation
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "reference_images": [
    "<string>"
  ],
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "watermark": true
}
'
  • Async task API, returns a task ID after submission
  • Uses the new official Kling Turbo upstream protocol
  • Supports text-to-video and image-to-video with first-frame input only
  • resolution supports 720p and 1080p
  • duration supports 3s, 4s, 5s, 6s, 7s, 8s, 9s, 10s, 11s, 12s, 13s, 14s, 15s
  • aspect_ratio applies to text-to-video requests
  • watermark is a boolean toggle only; custom watermark payloads are not supported
Use publicly accessible image URLs. Do not pass base64 image data. Upload local images with the Upload Image API first.

​
Authorization

​
Authorization
string
required
All endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY

​
Request Parameters

​
model
string
required
Video generation model name, fixed as kling-v3-fast.
​
prompt
string
required
Text prompt. For image-to-video, this is sent to Kling Turbo as the prompt content item.
​
reference_images
string[]
Optional input images. For Kling Turbo image-to-video, only the first image is used as first_frame.
Tail frame input is not supported in this integration. Additional input images are ignored.
​
resolution
string
default:"720p"
Video resolution.Supported values:
  • 720p
  • 1080p
​
duration
integer
default:"5"
Video duration in seconds.Supported values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
​
aspect_ratio
string
default:"16:9"
Video aspect ratio for text-to-video.Supported values:
  • 16:9
  • 9:16
  • 1:1
​
watermark
boolean
default:"false"
Whether to add the official Kling watermark.

​
Examples

​
Text-to-Video

{
  "model": "kling-v3-fast",
  "prompt": "A cinematic shot of a red sports car driving through rain",
  "resolution": "720p",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Image-to-Video

{
  "model": "kling-v3-fast",
  "prompt": "Animate the character with subtle camera motion",
  "reference_images": ["https://example.com/first-frame.png"],
  "resolution": "1080p",
  "duration": 5,
  "watermark": true
}
Video generation is asynchronous. Use the Get Video Task Status endpoint to query progress and results.