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.5 is a single-shot model that adds the v3.5 style controls: either a free-form style_prompt (which fully overrides everything) or the structured trio color_palette / lighting / camera_moveset_style (each can be left as auto). It also exposes the full Higgsfield camera body, lens, focal length, and aperture preset slots.

​
Model

higgsfield-ai/cinematic-studio-video-3.5

​
Parameters

ParameterTypeRequiredDescription
promptstringYesRequired text prompt
image_urlsstring[]NoUp to 3 reference image URLs
start_image_urlstringNoOptional first-frame image
end_image_urlstringNoOptional last-frame image
durationintegerNoVideo duration in seconds (4-15)
aspect_ratiostringNoauto (default), 1:1, 3:4, 9:16, 4:3, 16:9, 21:9
resolutionstringNo480p, 720p, 1080p
genrestringNogeneral (default), action, horror, comedy, noir, epic, drama
generate_audiobooleanNoGenerate accompanying audio
seedintegerNoRandom seed; auto-generated if omitted
style_promptstringNoFree-form style description. When provided it FULLY OVERRIDES color_palette, lighting, and camera_moveset_style
color_palettestringNoColor grading preset. Sent as color_grading upstream. Ignored if style_prompt is set. Values: auto, naturalistic_clean, bleached_warm, hyper_neon, teal_orange_epic, sodium_decay, cold_steel, bleach_bypass, classic_bw
lightingstringNoLighting scheme. Sent as light_scheme upstream. Ignored if style_prompt is set. Values: auto, soft_cross, contre_jour, overhead_fall, window, practicals, silhouette
camera_moveset_stylestringNoCamera moveset style. Sent as camera_style upstream. Ignored if style_prompt is set. Values: auto, classic_static, silent_machine, one_take, epic_scale, …
camera_motion_idstringNoCamera movement preset id (sent as preset_id)
camera_model_idstringNoCamera body preset id (from GET /higgsfield/camera-settings)
camera_lens_idstringNoCamera lens preset id
camera_focal_length_idstringNoCamera focal length preset id
camera_aperture_idstringNoCamera aperture preset id

​
Notes

Calls Higgsfield /jobs/v2/cinematic_studio_video_3_5. Public → wire field renames:
Public fieldWire field
color_palettecolor_grading
lightinglight_scheme
camera_moveset_stylecamera_style
camera_motion_idpreset_id
This model is single-shot only — there is no shot_mode or multi_shots parameter.

​
Example - Structured Style

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.5",
    "input": {
      "prompt": "A lone detective walks through a rain-soaked alley at night",
      "duration": 8,
      "aspect_ratio": "21:9",
      "resolution": "1080p",
      "genre": "noir",
      "color_palette": "teal_orange_epic",
      "lighting": "contre_jour",
      "camera_moveset_style": "one_take",
      "generate_audio": true
    }
  }'

​
Example - Free-form Style Prompt

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.5",
    "input": {
      "prompt": "A cyberpunk samurai meditates on a rooftop overlooking neon Tokyo",
      "style_prompt": "Wong Kar-wai style: smeary highlights, step-printed motion, jewel-tone neons reflected in puddles, intimate handheld framing",
      "duration": 10,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "genre": "drama",
      "generate_audio": true
    }
  }'

​
Example - With Camera Body and Lens Presets

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.5",
    "input": {
      "prompt": "Wide anamorphic shot of a desert at golden hour",
      "duration": 6,
      "aspect_ratio": "21:9",
      "resolution": "1080p",
      "genre": "epic",
      "camera_model_id": "<camera-body-preset-id>",
      "camera_lens_id": "<lens-preset-id>",
      "camera_focal_length_id": "<focal-length-preset-id>",
      "camera_aperture_id": "<aperture-preset-id>",
      "camera_motion_id": "<motion-preset-id>"
    }
  }'

​
Response

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