Skip to main content
POST

Authorization

Authorization
string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Request Parameters

model
string
required
Video generation model nameSupported models:
  • kling-video-o1 - Kling Video O1 (reasoning-enhanced, highest quality)
prompt
string
required
Positive text promptSupports referencing images from image_urls using <<<image_N>>> syntax, where N starts from 1.Example: "Make the person in <<<image_1>>> wave at the camera"
If images are provided but the prompt does not contain any <<<image_N>>> reference, the system will automatically prepend <<<image_1>>> to the prompt.
mode
string
default:"std"
Generation modeOptions:
  • std - Standard mode (720P)
  • pro - Professional mode (1080P)
Default: std
duration
integer
default:"5"
Video duration (seconds)Options: 5 or 10Default: 5
aspect_ratio
string
default:"16:9"
Video aspect ratioOptions:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
Default: 16:9
image_urls
array<url>
Image URL array for image referencingReference corresponding images in the prompt using <<<image_N>>> syntax (N starts from 1)Example: ["https://example.png"]
  • Image URLs must be publicly accessible without hotlink protection
  • In image-to-video mode, aspect_ratio may be overridden by the actual image ratio
  • Up to two images. The first item in the array is the start frame, and the second is the end frame
image_with_roles
array<object>
Role-based image array, recommended for image-to-video.Each item format: { "url": "...", "role": "..." }
  • first_frame: first frame
  • last_frame: last frame
  • reference: reference image
  • image_urls and image_with_roles are mutually exclusive, do not pass both.
  • When more than 2 images are provided, setting start/end frames is not supported.
video_list
array
Reference video list (URL-based), up to 1 video.Use refer_type to distinguish types:
  • base: video to be edited (default)
  • feature: feature reference video
Use keep_original_sound to control whether to keep original audio:
  • no: do not keep (default)
  • yes: keep original sound
Request format:
  • video_url cannot be empty, and the video URL must be accessible
  • When refer_type=base:
    • Start/end frames cannot be defined
    • Reference video must be 3-10 seconds
    • Generated video duration follows the uploaded video
  • When refer_type=feature and video_url is not empty:
    • image_urls can only include a first-frame image
  • Video requirements: MP4/MOV only; duration at least 3 seconds; resolution 720px-2160px; frame rate 24-60fps (output is 24fps); size no more than 200MB

Image Reference Syntax

The Video O1 model uses <<<image_N>>> syntax to reference images in prompts, providing a unified text-to-video/image-to-video experience:
SyntaxDescription
<<<image_1>>>References the 1st image in the image_urls array
<<<image_2>>>References the 2nd image in the image_urls array
Auto Reference: If image_urls is provided but the prompt does not contain any <<<image_N>>> reference, the system will automatically prepend <<<image_1>>> to the prompt.

Response

code
integer
Response status code, 200 on success
data
array
Response data array

Use Cases

Case 1: Text-to-Video (Highest Quality)

Case 2: Image Reference (Single Image)

Case 3: Multiple Image References

Case 4: Image Provided Without Explicit Reference (Auto-added)

The system will automatically prepend <<<image_1>>> to the prompt, equivalent to "<<<image_1>>>The person slowly turns and smiles".
Query Task ResultsVideo generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.