Skip to main content
POST
/
v1
/
ai
/
image-to-video
/
runway-4-5
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-to-video/runway-4-5 \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "image": "https://storage.googleapis.com/fc-freepik-pro-rev1-eu-static/landing-api/examples/freepik__upload__53227.png",
  "prompt": "The subject slowly opens their eyes and smiles warmly, with a gentle camera zoom",
  "ratio": "1280:720",
  "duration": 8,
  "seed": 12345,
  "webhook_url": "https://example.com/webhook"
}
'
{
  "data": {
    "generated": [],
    "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

Source image for video generation. Supports Base64 encoding or HTTPS URL (must be publicly accessible).

Example:

"https://example.com/image.jpg"

​
prompt
string
required

Text prompt describing the desired motion and video content. Maximum 2000 characters.

Maximum string length: 2000
Example:

"The eagle spreads its wings and gracefully takes flight"

​
webhook_url
string<uri>

Webhook URL to notify when the task is completed

​
ratio
enum<string>
default:1280:720

Aspect ratio of the generated video.

  • 1280:720: Landscape (16:9)
  • 720:1280: Portrait (9:16)
  • 1104:832: Landscape (4:3)
  • 960:960: Square (1:1)
  • 832:1104: Portrait (3:4)
Available options:
1280:720,
720:1280,
1104:832,
960:960,
832:1104
​
duration
enum<integer>
default:5

Duration of the generated video in seconds (5, 8, or 10).

Available options:
5,
8,
10
​
seed
integer

Random seed for reproducible video generation. Use the same seed with identical parameters to generate the same video.

Required range: 0 <= x <= 4294967295

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}