Kling O1 Reference Image 2 Video Serverless API

Identity-preserving videos from static images with character reference.

~196.89s
~$1.345
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

Scene description. Use @Image1 for images, @Element1 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

Elements with frontal and reference images. Reference as @Element1.

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