GET
https://api.unifically.com
/
higgsfield
/
camera-movements
Get Camera Movements
curl --request GET \
  --url https://api.unifically.com/higgsfield/camera-movements \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "success": true,
  "data": {
    "has_more": false,
    "cursor": null,
    "items": [
      {
        "id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
        "name": "Zoom in",
        "description": "",
        "media": {
          "url": "https://cdn.higgsfield.ai/cinematic_studio_video/example.mp4",
          "type": "video",
          "width": 600,
          "height": 600,
          "thumbnail_url": "https://cdn.higgsfield.ai/cinematic_studio_video/example-thumb.webp"
        }
      },
      {
        "id": "63468666-8652-40d9-8539-708e62c74846",
        "name": "Tilt up",
        "description": "",
        "media": {
          "url": "https://cdn.higgsfield.ai/cinematic_studio_video/example2.mp4",
          "type": "video",
          "width": 600,
          "height": 600,
          "thumbnail_url": "https://cdn.higgsfield.ai/cinematic_studio_video/example2-thumb.webp"
        }
      }
    ]
  }
}
Retrieve available camera movement presets that can be applied to video generation with Higgsfield Cinematic Studio.

​
Request

curl -X GET "https://api.unifically.com/higgsfield/camera-movements?size=21" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Query Parameters

​
size
integer
Number of camera movement presets to return.Default: 21Maximum recommended: 50

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "has_more": false,
    "cursor": null,
    "items": [
      {
        "id": "fc583228-7a2e-4e94-8c3b-38962895e99d",
        "name": "Zoom in",
        "description": "",
        "media": {
          "url": "https://cdn.higgsfield.ai/cinematic_studio_video/example.mp4",
          "type": "video",
          "width": 600,
          "height": 600,
          "thumbnail_url": "https://cdn.higgsfield.ai/cinematic_studio_video/example-thumb.webp"
        }
      },
      {
        "id": "63468666-8652-40d9-8539-708e62c74846",
        "name": "Tilt up",
        "description": "",
        "media": {
          "url": "https://cdn.higgsfield.ai/cinematic_studio_video/example2.mp4",
          "type": "video",
          "width": 600,
          "height": 600,
          "thumbnail_url": "https://cdn.higgsfield.ai/cinematic_studio_video/example2-thumb.webp"
        }
      }
    ]
  }
}

​
Response Fields

​
code
integer
Status code of the request
​
success
boolean
Whether the request was successful
​
data
object
Response data
​
has_more
boolean
Whether there are more presets available
​
cursor
string
Cursor for pagination (null if no more results)
​
items
array
Array of camera movement presets
​
id
string
Unique identifier for the preset. Use this as preset_id in generate requests.
​
name
string
Human-readable name of the camera movement
​
description
string
Description of the camera movement effect
​
media
object
Preview media for the camera movement
​
url
string
URL of the preview video
​
type
string
Media type (video)
​
width
integer
Preview width in pixels
​
height
integer
Preview height in pixels
​
thumbnail_url
string
URL of the thumbnail image

​
Available Camera Movements

Common presets include:
NameDescription
StaticNo camera movement
Zoom inCamera zooms into the subject
Zoom outCamera zooms away from the subject
Tilt upCamera tilts upward
Tilt downCamera tilts downward
Pan leftCamera pans to the left
Pan rightCamera pans to the right
Camera movements are cached for 30 minutes to improve performance. Browse the presets and save the IDs you want to use frequently.

​
Usage

Use the id from a camera movement preset as the preset_id parameter when generating videos: 
{
  "prompt": "Dramatic zoom revealing the landscape",
  "start_image_url": "https://example.com/landscape.jpg",
  "preset_id": "fc583228-7a2e-4e94-8c3b-38962895e99d"
}