Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
wan-v2-2-480p
Create a video from image - Wan v2.2 480p
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-to-video/wan-v2-2-480p \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '{
  "webhook_url": "https://www.example.com/webhook",
  "image": "https://img.freepik.com/free-photo/beautiful-girl-dancing_123456-7890.jpg",
  "prompt": "A beautiful girl opens her eyes and smiles warmly, the camera gently zooms in capturing the sparkle in her eyes, soft natural lighting",
  "duration": "5",
  "aspect_ratio": "auto",
  "seed": 70
}'
{
  "data": {
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

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
​
image
string
required

The image to use for the video generation. Supported formats: URL of the image or base64 encoding of the image.

Example:

"https://img.freepik.com/free-photo/beautiful-girl-dancing_123456-7890.jpg"

​
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"

​
prompt
string

The text content used for the video generation. This is the main description of the video to be generated.

Maximum length: 2000
Example:

"A beautiful girl opens her eyes and smiles warmly, the camera gently zooms in capturing the sparkle in her eyes, soft natural lighting"

​
duration
enum<string>
default:5

Video duration in seconds

Available options:
5,
10
Example:

"5"

​
aspect_ratio
enum<string>
default:auto

Video aspect ratio.`

Available options:
auto,
widescreen_16_9,
social_story_9_16,
square_1_1,
classic_4_3
Example:

"auto"

​
seed
integer

Random seed for video generation.

Example:

70

Response

OK - Task created successfully

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