Generate cinematic videos from images with professional camera movement effects.

​
Model

higgsfield-ai/cinematic-studio-video

​
Parameters

ParameterTypeRequiredDescription
promptstringNoText description
start_image_urlstringYesStarting frame image URL
end_image_urlstringNoEnding frame (disables preset_id, sound, slow_motion)
durationintegerNo5 or 10 seconds
aspect_ratiostringNo1:1, 3:4, 2:3, 9:16, 3:2, 4:3, 16:9, 21:9
preset_idstringNoCamera movement preset ID
soundbooleanNoEnable AI-generated sound
slow_motionbooleanNoEnable slow motion effect
seedintegerNo0-999999 for reproducibility

​
Generation Modes

Mode 1: Start Image Only (Full Features)
  • Camera movement presets (preset_id)
  • Sound generation (sound)
  • Slow motion effect (slow_motion)
Mode 2: Start + End Image (Transition Mode)
  • Video transitions between the two images
  • preset_id, sound, and slow_motion are ignored

​
Example - Basic Generation

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "higgsfield-ai/cinematic-studio-video",
    "input": {
      "prompt": "A gentle breeze moves through the scene",
      "start_image_url": "https://example.com/image.jpg",
      "duration": 10,
      "aspect_ratio": "16:9"
    }
  }'

​
Example - With Camera Movement

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "higgsfield-ai/cinematic-studio-video",
    "input": {
      "prompt": "Dramatic zoom into the subject",
      "start_image_url": "https://example.com/image.jpg",
      "duration": 5,
      "aspect_ratio": "21:9",
      "preset_id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
      "sound": true,
      "slow_motion": false
    }
  }'

​
Example - Image Transition

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "higgsfield-ai/cinematic-studio-video",
    "input": {
      "prompt": "Smooth transition between scenes",
      "start_image_url": "https://example.com/start.jpg",
      "end_image_url": "https://example.com/end.jpg",
      "duration": 10,
      "aspect_ratio": "16:9"
    }
  }'

​
Supported Aspect Ratios

Aspect RatioResolution
1:11280x1280
3:41080x1440
2:31080x1620
9:161080x1920
3:21620x1080
4:31440x1080
16:91920x1080
21:92520x1080

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}

​
Pricing

DurationSoundPrice
5sOn$0.16
5sOff$0.10
10sOn$0.36
10sOff$0.20