Prerequisites
Before you begin, make sure you have:
A Plus or Pro plan
API access is not available on the Free or Starter plans.
Upgrade your plan to get started.
Step 1: Get your API Key
Navigate to your API settings and create a new API key.
Your API key will only be shown once. Store it securely and never commit it to version control.
Your API key will look like this:
vpk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ123456
Step 2: Create your first video
Use the following command to create a slideshow video. Replace vpk_live_xxxxx with your actual API key:
curl -X POST https://api.vibepeak.ai/v1/real-estate/narrated-slideshow \
-H "Authorization: Bearer vpk_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"images": [
"https://images.unsplash.com/photo-1600596542815-ffad4c1539a9?w=1200",
"https://images.unsplash.com/photo-1600607687939-ce8a6c25118c?w=1200",
"https://images.unsplash.com/photo-1600566753086-00f18fb6b3ea?w=1200",
"https://images.unsplash.com/photo-1600585154340-be6161a56a0c?w=1200",
"https://images.unsplash.com/photo-1600573472592-401b489a3cdc?w=1200",
"https://images.unsplash.com/photo-1600047509807-ba8f99d2cdde?w=1200"
]
}'
You’ll receive a response like:
{
"task_id": "task_abc123xyz",
"status": "queued",
"queue_position": 1,
"estimated_completion": "2026-01-04T12:30:00Z",
"created_at": "2026-01-04T12:00:00Z"
}
Step 3: Check task status
Video generation takes a few minutes. You can poll the task status:
curl https://api.vibepeak.ai/v1/tasks/task_abc123xyz \
-H "Authorization: Bearer vpk_live_xxxxx"
When the task is complete, you’ll receive:
{
"task_id": "task_abc123xyz",
"status": "completed",
"result": {
"video_url": "https://storage.vibepeak.ai/videos/task_abc123xyz.mp4",
"duration_seconds": 45,
"resolution": "1080p",
"expires_at": "2026-01-11T12:15:00Z"
}
}
Step 4: Download your video
The video_url in the result is a direct download link. The URL is valid for 7 days.
For production use, we recommend setting up webhooks
instead of polling. You’ll be notified as soon as your video is ready.
Next steps