Generate cinematic videos with camera movement presets, multi-shot support, genres, and AI sound effects.

​
Model

higgsfield-ai/cinematic-studio-video

​
Parameters

ParameterTypeRequiredDescription
promptstringConditionalText description. Required for single and multi_shot_auto shot modes. Can include image references like <<<image_1>>>, <<<image_2>>>, <<<image_3>>>
shot_modestringNoControls multi-shot behavior: single (default), multi_shot_auto, multi_shot_manual
multi_shotsobject[]ConditionalArray of shot definitions. Required for multi_shot_manual mode. Each object has: prompt (string, required), duration (integer, required), camera_movement_id (string, optional)
image_urlsstring[]NoReference image URLs (max 3). Reference in prompts as <<<image_1>>>, <<<image_2>>>, <<<image_3>>>
start_image_urlstringNoStarting frame image URL
end_image_urlstringNoEnding frame image URL. When provided, sound is forced to false
durationintegerNoDuration in seconds (3-12). Default: 5
aspect_ratiostringNo1:1, 3:4, 2:3, 9:16, 3:2, 4:3, 16:9, 21:9. Default: 16:9
resolutionstringNo720p (default) or 1080p
genrestringNoauto (default), action, horror, comedy, western, suspense, intimate, spectacle
camera_movement_idstringNoCamera movement preset ID from Resources API
soundbooleanNoEnable AI-generated sound effects. Default: false. Forced to false when end_image_url is provided
seedintegerNo0-999999 for reproducibility

​
Shot Modes

Single (default) Standard single-shot video generation. Requires prompt. Multi-Shot Auto Automatically splits the video into multiple shots. Requires prompt. The system determines shot boundaries and transitions. Multi-Shot Manual User defines each shot individually via the multi_shots array. Each shot has its own prompt, duration, and optional camera_movement_id.

​
Example - Single Shot with Reference Images

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": "<<<image_1>>> A cinematic scene with dramatic lighting <<<image_2>>>",
      "image_urls": [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "genre": "action",
      "camera_movement_id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
      "sound": true
    }
  }'

​
Example - With Start and End Frames

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": 7,
      "aspect_ratio": "21:9",
      "resolution": "720p",
      "genre": "auto"
    }
  }'

​
Example - Multi-Shot Auto

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": "An epic journey through a fantasy landscape",
      "shot_mode": "multi_shot_auto",
      "duration": 10,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "genre": "spectacle"
    }
  }'

​
Example - Multi-Shot Manual

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": {
      "shot_mode": "multi_shot_manual",
      "multi_shots": [
        {
          "prompt": "Wide establishing shot of the city skyline",
          "duration": 3,
          "camera_movement_id": "fc583228-7a2e-4e94-8c3b-38962895e99d"
        },
        {
          "prompt": "Close-up of the main character walking",
          "duration": 4,
          "camera_movement_id": "63468666-8652-40d9-8539-708e62c74846"
        },
        {
          "prompt": "Dramatic reveal of the destination",
          "duration": 3
        }
      ],
      "duration": 10,
      "image_urls": ["https://example.com/ref1.jpg"],
      "aspect_ratio": "21:9",
      "resolution": "1080p",
      "genre": "suspense"
    }
  }'

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