Create video generation task
Submit a text-to-video or image-to-video task supporting Kling, Veo, and more
Available models
Pass any video generation model ID inmodel, for example:
| Model ID | Notes |
|---|---|
kling-v2-5-turbo | Kling latest Turbo — balanced speed and quality |
kling-v2-1-master | Kling flagship Master — highest quality |
veo_3_1 | Google Veo 3.1 — top-tier video quality |
veo_3_1-fast | Google Veo 3.1 Fast — lower cost |
Call flow
POST /v1/video/generations— submit task, gettask_idGET /v1/video/generations/{task_id}— poll untilstatus=completed- Read the
urlfield from the response to download the video
Image-to-video
Set theimage field (URL or Base64) to trigger image-to-video mode.
The model will animate the content of the provided image.
Extended parameters
For some models,metadata accepts model-specific fields such as
negative_prompt, style, or quality_level. Supported fields vary
by model — refer to the model’s own documentation.Authorizations
Body
Generic video generation request body.
Model ID. Supports multi-vendor video models such as Kling and Veo.
Examples: kling-v2-5-turbo, kling-v2-1-master, veo_3_1, veo_3_1-fast.
"kling-v2-5-turbo"
Text prompt describing the video content, scene, camera work, and style.
"An astronaut walking on the Moon, Earth rising in the background, cinematic shot"
Reference image — URL or Base64 data URI. When set, triggers image-to-video mode and the model animates the image content.
"https://example.com/image.jpg"
Video duration in seconds.
5
Video width in pixels.
1280
Video height in pixels.
720
Video frame rate (fps).
30
Random seed. Using the same seed and parameters tends to produce similar results.
20231234
Number of videos to generate. Recommended to keep at 1 for async tasks.
1
Response format. Use url.
"url"
End-user identifier for auditing and abuse monitoring; not used in generation.
"user-1234"
Extended parameters for model-specific fields such as
negative_prompt, style, or quality_level.
Supported fields vary by model.