Kling O1 Reference Image 2 Video Serverless API

Kling Omni Video O1 transforms static images into dynamic, identity-preserving cinematic videos.

~199.36s
~$1.333
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/kling-o1-reference-image-to-video"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "prompt": "Create a cinematic video sequence with smooth camera movements of @image1 riding on @image2",
12    "image_urls": [
13        "https://segmind-resources.s3.amazonaws.com/output/01641ffc-a5dc-4383-a978-8d14f785247d-Screenshot_2025-11-24_120343.png",
14        "https://segmind-resources.s3.amazonaws.com/output/5aab39a0-7dbb-42c3-9269-bf52141ae0ca-horse.jpg"
15    ],
16    "duration": "5",
17    "aspect_ratio": "16:9"
18}
19
20response = requests.post(url, headers=headers, json=data)
21
22if response.status_code == 200:
23    result = response.json()
24    print(json.dumps(result, indent=2))
25else:
26    print(f"Error: {response.status_code}")
27    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/kling-o1-reference-image-to-video

Parameters

image_urlsrequired
string[]

List of reference image URLs. Reference them as @Image1, @Image2 in prompt

promptrequired
string

Detailed scene description. Use @Image1, @Image2 for images and @Element1, @Element2 for elements

aspect_ratiooptional
string

Sets frame dimensions

Default: "16:9"
Allowed values :
"16:9""9:16""1:1"
durationoptional
integer

Video duration in seconds

Default: 5
Allowed values :
510
elementsoptional
string

List of elements with reference and frontal images. Each element should have 'reference_image_urls' (list) and 'frontal_image_url' (str). Reference as @Element1, @Element2 in prompt

Default: null

Response Type

Returns: Video

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out