Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
kling-elements-pro
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-to-video/kling-elements-pro \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '{
  "images": [
    "https://img.freepik.com/foto-gratis/disparo-aislado-gatito-jengibre-sentado-frente-blanco-mirando-derecha_181624-45937.jpg?semt=ais_hybrid&w=740"
  ]
}'
{
  "data": {
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

​
Important

The service allows up to 3 concurrent requests per user.

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
​
images
string[]
required

Array of up to 4 images to use for video generation. Images must be at least 300x300px, aspect ratio between 1:2.5 ~ 2.5:1, and under 10MB

Maximum length: 4

Image URL (must be accessible). Supported formats: jpg, jpeg, png

​
prompt
string

Positive text prompt

Maximum length: 2500
​
negative_prompt
string

Negative text prompt

Maximum length: 2500
​
duration
enum<string>

Duration of the generated video in seconds

Available options:
5,
10
​
aspect_ratio
enum<string>
default:widescreen_16_9

Aspect ratio for the generated video

Available options:
widescreen_16_9,
social_story_9_16,
square_1_1
​
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"

Response

OK - Get the status of the kling-elements-pro task

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED"
}