Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
kling-o1-std-video-reference
Video generation with reference images using Kling O1 Standard
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-to-video/kling-o1-std-video-reference \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "webhook_url": "https://www.example.com/webhook",
  "reference_images": [
    "https://example.com/character-reference.jpg"
  ],
  "aspect_ratio": "16:9",
  "duration": 5
}
'
"<unknown>"

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json

Generate video using Kling O1 with reference images for character/style consistency.

Best for:

  • Maintaining character consistency across shots
  • Creating videos with specific visual style
  • Multi-shot storytelling with consistent subjects
​
prompt
string
required

Text prompt describing the video you want to generate. Be specific about actions, camera movements, and mood.

Maximum string length: 2500
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

​
reference_images
string[]

List of reference images for maintaining visual consistency (up to 7). Each image can be a URL or Base64 encoded string.

Maximum array length: 7
Example:
[
  "https://example.com/character-reference.jpg"
]
​
aspect_ratio
enum<string>
default:16:9
Available options:
16:9,
9:16,
1:1
​
duration
enum<integer>
default:5
Available options:
5,
10

Response

OK

OK - The task exists and the status is returned