POST
https://api.unifically.com
/
higgsfield
/
cinematic-studio-video
/
generate
Generate Video
curl --request POST \
  --url https://api.unifically.com/higgsfield/cinematic-studio-video/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "start_image_url": "<string>",
  "prompt": "<string>",
  "end_image_url": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "seed": 123,
  "preset_id": "<string>",
  "sound": true,
  "slow_motion": true,
  "callback_url": "<string>"
}
'
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
Generate cinematic videos from one or two images with professional camera movement effects using Higgsfield Cinematic Studio.

​
Pricing

DurationSoundPrice (USD)
5sOn$0.16
5sOff$0.10
10sOn$0.36
10sOff$0.20

​
Generation Modes

​
Mode 1: Start Image Only (Full Features)

When only start_image_url is provided, all features are available:
  • Camera movement presets (preset_id)
  • Sound generation (sound)
  • Slow motion effect (slow_motion)

​
Mode 2: Start + End Image (Transition Mode)

When both start_image_url and end_image_url are provided:
  • Video transitions between the two images
  • preset_id, sound, and slow_motion are ignored
  • Only basic parameters apply: prompt, duration, aspect_ratio, seed

​
Request - Basic Generation

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

​
Request - With Camera Movement

curl -X POST "https://api.unifically.com/higgsfield/cinematic-studio-video/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "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,
    "seed": 12345
  }'

​
Request - Image Transition

curl -X POST "https://api.unifically.com/higgsfield/cinematic-studio-video/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "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"
  }'

​
Parameters

​
Required Parameters

​
start_image_url
string
required
URL of the starting image. Must be a publicly accessible image URL (JPEG, PNG, WebP). This is the initial frame of the video.

​
Optional Parameters

​
prompt
string
Text description to guide the video generation. Describes the desired motion or scene.
​
end_image_url
string
URL of the ending image. When provided, the video will transition from the start image to this end image.
When end_image_url is set, preset_id, sound, and slow_motion parameters are ignored.
​
duration
integer
Duration of the generated video in seconds.Options: 5, 10Default: 10
​
aspect_ratio
string
Aspect ratio of the output video.Options: 1:1, 3:4, 2:3, 9:16, 3:2, 4:3, 16:9, 21:9Default: 16:9
​
seed
integer
Seed for reproducible generation. Using the same seed with identical parameters will produce similar results.Range: 0-999999
​
preset_id
string
ID of a camera movement preset from the Camera Movements endpoint.
Only available when end_image_url is not provided.
​
sound
boolean
Enable AI-generated sound effects for the video.Default: false
Only available when end_image_url is not provided.
​
slow_motion
boolean
Enable slow motion effect on the generated video.Default: false
Only available when end_image_url is not provided.
​
callback_url
string
URL to receive webhook notification on completion. See Callback documentation.

​
Supported Aspect Ratios

Aspect RatioResolutionDescription
1:11280x1280Square format
3:41080x1440Portrait
2:31080x1620Portrait (taller)
9:161080x1920Vertical/Mobile
3:21620x1080Landscape
4:31440x1080Standard
16:91920x1080Widescreen (default)
21:92520x1080Ultrawide/Cinematic

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
Response Fields

​
code
integer
Status code of the request
​
success
boolean
Whether the request was successful
​
data
object
Response data
​
task_id
string
Unique identifier for the generation task
Use the task_id to check the status using the Get Task endpoint.

​
Best Practices

Camera Movements

Use Camera Movements endpoint to browse available presets

High-Quality Images

Use high-resolution, publicly accessible images for best results

Cinematic Ratios

Use 21:9 aspect ratio for ultrawide cinematic effects

Reproducibility

Use the same seed value to reproduce similar results
Generation time typically takes 1-5 minutes depending on duration and server load.