Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unifically.com/llms.txt

Use this file to discover all available pages before exploring further.

Cinematic Studio Video v3.0 adds per-shot speedramp control, native audio generation, an expanded resolution range (480p / 720p / 1080p), and a refreshed genre set.

​
Model

higgsfield-ai/cinematic-studio-video-3.0

​
Parameters

ParameterTypeRequiredDescription
promptstringConditionalText prompt. Required when shot_mode is single or multi_shot_auto
shot_modestringNosingle (default), multi_shot_auto, multi_shot_manual. single and multi_shot_auto produce the same wire payload (auto cuts). multi_shot_manual requires the multi_shots array
multi_shotsobject[]ConditionalRequired when shot_mode='multi_shot_manual'. Each item carries its own speedramp + camera movement. See Multi-Shot Manual below
image_urlsstring[]NoUp to 3 reference image URLs
start_image_urlstringNoOptional first-frame image
end_image_urlstringNoOptional last-frame image
durationintegerNoTotal video duration in seconds (4-15)
aspect_ratiostringNoauto (default — model picks; otherwise dims are derived from the ratio), 1:1, 3:4, 9:16, 4:3, 16:9, 21:9
resolutionstringNo480p, 720p, 1080p
genrestringNogeneral (default), action, horror, comedy, noir, epic
camera_motion_idstringNoTop-level camera movement preset id (sent as preset_id)
generate_audiobooleanNoGenerate accompanying audio
seedintegerNoRandom seed; auto-generated if omitted

​
Shot Modes

Single (default) Standard single-shot video generation. Requires prompt. Multi-Shot Auto Produces the same wire payload as single (auto cuts). Requires prompt. Multi-Shot Manual User defines each shot individually via multi_shots. Each shot can have its own speedramp and camera movement.

​
Multi-Shot Manual

Each item in multi_shots accepts:
FieldTypeDescription
promptstringPer-shot text prompt
durationintegerPer-shot duration in seconds
camera_motion_idstringCamera movement preset id (sent as preset_id)
speedrampstringOne of ramp_up, flash_in, flash_out, hero_moment. Wire mapping: ramp_up → speedup, flash_in → fast_to_slowmo, flash_out → slowmo_to_fast, hero_moment → impact

​
Notes

Calls Higgsfield /jobs/v2/cinematic_studio_3_0. A single-shot request is internally mapped to multi_shots=true, multi_shot_mode=auto, multi_prompt=[] per Higgsfield’s wire format.

​
Example - Single Shot

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-3.0",
    "input": {
      "prompt": "A cinematic dolly shot through a neon-lit alley at night",
      "duration": 8,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "genre": "noir",
      "generate_audio": true
    }
  }'

​
Example - With Reference Images and Camera Motion

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-3.0",
    "input": {
      "prompt": "Hero walks toward camera in slow motion",
      "image_urls": [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      "camera_motion_id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
      "duration": 6,
      "aspect_ratio": "21:9",
      "resolution": "1080p",
      "genre": "epic",
      "generate_audio": true
    }
  }'

​
Example - Multi-Shot Manual with Speedramps

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-3.0",
    "input": {
      "shot_mode": "multi_shot_manual",
      "multi_shots": [
        {
          "prompt": "Wide establishing shot of a futuristic city skyline",
          "duration": 4,
          "camera_motion_id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
          "speedramp": "ramp_up"
        },
        {
          "prompt": "Close-up of the protagonist looking up at the skyline",
          "duration": 5,
          "speedramp": "hero_moment"
        },
        {
          "prompt": "Sudden snap cut to a dramatic reveal",
          "duration": 4,
          "speedramp": "flash_out"
        }
      ],
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "genre": "action",
      "generate_audio": true
    }
  }'

​
Response

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