Higgsfield Cinematic Studio Image API

Text to Image

Cinematic images with professional camera settings. Adjustable lens, aperture, and focal length.

·Features·FAQ

Documentation

Prompt *

Text description of the image to generate

Aspect Ratio

Output aspect ratio

Resolution

Output resolution of the generated image

Reference Images

Up to 4 reference images to guide generation (optional)

0/4

Click or drag & dropPNG, JPG, WEBP, GIF · Max 100MB

Seed

Seed for reproducibility (0-999999)

Camera Model

Camera model setting from the Camera Settings API

Lens Type

Lens setting affecting perspective and distortion

Aperture

Aperture setting for depth of field and bokeh

Focal Length

Focal length affecting field of view

Output

Your generated image will appear here

Features

What Higgsfield Cinematic Studio Image API offers

Text-to-image with optional cinematic camera preset IDs (camera_model_id, camera_lens_id, camera_aperture_id, camera_focal_length_id)

Preset IDs come from Higgsfield's Camera Settings API rather than raw millimeter or f-stop strings in the payload

Eight aspect ratios including 21:9 for widescreen compositions

Output resolution presets: 1k default, 2k for web hero assets, 4k for print-minded exports

Up to four optional reference images to steer composition or subject

Optional seed between 0 and 999999 for reproducibility

Dedicated generate and poll endpoints under the Higgsfield namespace

Use cases

Built for

Primary

Look bible stills - Lock lens and body presets so every shot in a campaign matches

Billboard comps - 4k exports when text overlays will be applied downstream

Automotive renders - Ultrawide frames with cinematic glass without a full CGI scene

Portrait marketing - Aperture presets that emphasize bokeh when IDs are wired correctly

Multi-reference layouts - Up to four plates for collage-style direction

Rapid location scouting - Text plus references to explore lighting before a shoot

FAQ

About Higgsfield Cinematic Studio Image API

You pass UUID-style preset identifiers for camera body, lens, aperture, and focal length. Fetch the valid IDs from Higgsfield's Camera Settings API instead of typing manual focal lengths.

The model still renders from prompt, aspect_ratio, and resolution. Camera IDs are optional modifiers when you need a specific photographic look.

1k is ideal for previews, 2k covers most web placements, and 4k is meant for large-format or print workflows where extra pixels matter.

Yes. You can upload up to four images. Combine them with precise prompts when you need to anchor subjects or environments.