Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
wan-v2-2-720p
WAN 2.2 720p - Create video from image
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-to-video/wan-v2-2-720p \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "image": "https://img.freepik.com/free-photo/beautiful-girl-dancing_123456-7890.jpg",
  "webhook_url": "https://www.example.com/webhook",
  "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. Each dimension (width and height) must be between 240px and 8000px. Accepted image formats: JPEG, PNG, WebP. Maximum file size: 10MB.

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 string 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"
}