GET
https://api.unifically.com
/
higgsfield
/
camera-settings
Get Camera Settings
curl --request GET \
  --url https://api.unifically.com/higgsfield/camera-settings \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "success": true,
  "data": {
    "camera_models": [
      {
        "id": "cm-001",
        "name": "Professional DSLR",
        "description": "Full-frame sensor with cinematic color science"
      },
      {
        "id": "cm-002",
        "name": "Medium Format",
        "description": "Larger sensor for exceptional detail and dynamic range"
      }
    ],
    "camera_lenses": [
      {
        "id": "cl-001",
        "name": "Standard Prime",
        "description": "Sharp, natural perspective"
      },
      {
        "id": "cl-002",
        "name": "Wide Angle",
        "description": "Expansive field of view"
      },
      {
        "id": "cl-003",
        "name": "Telephoto",
        "description": "Compressed perspective, great for portraits"
      }
    ],
    "camera_apertures": [
      {
        "id": "ca-001",
        "name": "f/1.4",
        "description": "Very shallow depth of field, strong bokeh"
      },
      {
        "id": "ca-002",
        "name": "f/2.8",
        "description": "Moderate bokeh, good subject separation"
      },
      {
        "id": "ca-003",
        "name": "f/8",
        "description": "Sharp throughout, deep depth of field"
      }
    ],
    "camera_focal_lengths": [
      {
        "id": "cf-001",
        "name": "24mm",
        "description": "Wide angle, great for landscapes"
      },
      {
        "id": "cf-002",
        "name": "50mm",
        "description": "Natural perspective, versatile"
      },
      {
        "id": "cf-003",
        "name": "85mm",
        "description": "Portrait focal length, flattering compression"
      },
      {
        "id": "cf-004",
        "name": "135mm",
        "description": "Telephoto, strong compression"
      }
    ]
  }
}
Retrieve available camera settings that can be applied to image generation with Higgsfield Cinematic Studio Image.

​
Request

curl -X GET "https://api.unifically.com/higgsfield/camera-settings" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "camera_models": [
      {
        "id": "cm-001",
        "name": "Professional DSLR",
        "description": "Full-frame sensor with cinematic color science"
      },
      {
        "id": "cm-002",
        "name": "Medium Format",
        "description": "Larger sensor for exceptional detail and dynamic range"
      }
    ],
    "camera_lenses": [
      {
        "id": "cl-001",
        "name": "Standard Prime",
        "description": "Sharp, natural perspective"
      },
      {
        "id": "cl-002",
        "name": "Wide Angle",
        "description": "Expansive field of view"
      },
      {
        "id": "cl-003",
        "name": "Telephoto",
        "description": "Compressed perspective, great for portraits"
      }
    ],
    "camera_apertures": [
      {
        "id": "ca-001",
        "name": "f/1.4",
        "description": "Very shallow depth of field, strong bokeh"
      },
      {
        "id": "ca-002",
        "name": "f/2.8",
        "description": "Moderate bokeh, good subject separation"
      },
      {
        "id": "ca-003",
        "name": "f/8",
        "description": "Sharp throughout, deep depth of field"
      }
    ],
    "camera_focal_lengths": [
      {
        "id": "cf-001",
        "name": "24mm",
        "description": "Wide angle, great for landscapes"
      },
      {
        "id": "cf-002",
        "name": "50mm",
        "description": "Natural perspective, versatile"
      },
      {
        "id": "cf-003",
        "name": "85mm",
        "description": "Portrait focal length, flattering compression"
      },
      {
        "id": "cf-004",
        "name": "135mm",
        "description": "Telephoto, strong compression"
      }
    ]
  }
}

​
Response Fields

​
code
integer
Status code of the request
​
success
boolean
Whether the request was successful
​
data
object
Response data containing all camera settings
​
camera_models
array
Available camera models
​
id
string
Unique identifier. Use as camera_model_id in generate requests.
​
name
string
Human-readable name
​
description
string
Description of the camera characteristics
​
camera_lenses
array
Available lens types
​
id
string
Unique identifier. Use as camera_lens_id in generate requests.
​
name
string
Human-readable name
​
description
string
Description of the lens characteristics
​
camera_apertures
array
Available aperture settings
​
id
string
Unique identifier. Use as camera_aperture_id in generate requests.
​
name
string
Aperture value (f-stop)
​
description
string
Description of the depth of field effect
​
camera_focal_lengths
array
Available focal length settings
​
id
string
Unique identifier. Use as camera_focal_length_id in generate requests.
​
name
string
Focal length in millimeters
​
description
string
Description of the perspective effect

​
Camera Settings Guide

​
Camera Models

Different camera models simulate various sensor characteristics:
  • Professional DSLR - Full-frame look with natural colors
  • Medium Format - Exceptional detail and dynamic range
  • Mirrorless - Modern rendering with fast autofocus simulation

​
Lenses

Lens choice affects distortion and rendering:
  • Wide Angle - Expansive views, some barrel distortion
  • Standard Prime - Natural, undistorted perspective
  • Telephoto - Compressed backgrounds, subject isolation

​
Apertures

Aperture controls depth of field:
  • Wide (f/1.4-f/2) - Shallow focus, creamy bokeh
  • Medium (f/2.8-f/5.6) - Balanced sharpness and blur
  • Narrow (f/8+) - Everything in focus

​
Focal Lengths

Focal length affects perspective:
  • Wide (24mm) - Dramatic, expansive
  • Normal (50mm) - Natural, human-eye-like
  • Telephoto (85mm+) - Flattering compression

​
Usage

Use the IDs from camera settings when generating images: 
{
  "prompt": "Portrait with beautiful bokeh",
  "resolution": "4k",
  "camera_model_id": "cm-001",
  "camera_lens_id": "cl-003",
  "camera_aperture_id": "ca-001",
  "camera_focal_length_id": "cf-003"
}
For portrait photography, try combining a telephoto lens (85mm+) with a wide aperture (f/1.4-f/2.8) for professional-looking subject separation and bokeh.