Skip to main content
POST
/
v1
/
ai
/
text-to-video
/
ltx-2-pro
LTX Video 2.0 Pro - Create video from text
curl --request POST \
  --url https://api.freepik.com/v1/ai/text-to-video/ltx-2-pro \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "prompt": "A majestic eagle soaring through mountain valleys at sunset",
  "webhook_url": "<string>",
  "generate_audio": false,
  "seed": 12345,
  "resolution": "1080p",
  "duration": 6,
  "fps": 25
}
'
{
  "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
​
prompt
string
required

Text prompt describing the desired video content.

Tips:

  • Be specific about scenes, subjects, and visual details
  • Describe motion and camera movements
  • Mention lighting and atmosphere

Example: "A majestic eagle soaring through mountain valleys at sunset, camera slowly panning to follow the flight"

Maximum string length: 2000
Example:

"A majestic eagle soaring through mountain valleys at sunset"

​
webhook_url
string<uri>

Webhook URL to notify when the task is completed

​
generate_audio
boolean
default:false

Whether to generate synchronized audio for the video

Example:

false

​
seed
integer

Random seed for reproducibility. Use the same seed with identical parameters for similar results.

Required range: 0 <= x <= 4294967295
Example:

12345

​
resolution
enum<string>
default:1080p

Video resolution

Available options:
1080p,
1440p,
2160p
Example:

"1080p"

​
duration
enum<integer>
default:6

Video duration in seconds. Pro model supports 6, 8, or 10 seconds.

Available options:
6,
8,
10
Example:

6

​
fps
enum<integer>
default:25

Frames per second for the generated video. Note: 50 FPS is only available for durations up to 10 seconds.

Available options:
25,
50
Example:

25

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