POST
https://api.unifically.com
/
higgsfield
/
cinematic-studio-image
/
generate
Generate Image
curl --request POST \
  --url https://api.unifically.com/higgsfield/cinematic-studio-image/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "resolution": "<string>",
  "image_urls": [
    {}
  ],
  "camera_model_id": "<string>",
  "camera_lens_id": "<string>",
  "camera_aperture_id": "<string>",
  "camera_focal_length_id": "<string>",
  "callback_url": "<string>"
}
'
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
Generate high-quality cinematic images with professional camera settings including camera model, lens, aperture, and focal length.

​
Pricing

ResolutionPrice (USD)
1k$0.03
2k$0.03
4k$0.06

​
Request

curl -X POST "https://api.unifically.com/higgsfield/cinematic-studio-image/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "A serene mountain landscape at golden hour",
    "resolution": "2k"
  }'

​
Request - With Camera Settings

curl -X POST "https://api.unifically.com/higgsfield/cinematic-studio-image/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "Portrait of a person in natural lighting",
    "resolution": "4k",
    "image_urls": ["https://example.com/reference1.jpg"],
    "camera_model_id": "camera-model-uuid",
    "camera_lens_id": "camera-lens-uuid",
    "camera_aperture_id": "camera-aperture-uuid",
    "camera_focal_length_id": "camera-focal-length-uuid"
  }'

​
Parameters

​
Required Parameters

​
prompt
string
required
Text description of the image to generate. Describe the scene, style, lighting, and composition.

​
Optional Parameters

​
resolution
string
Output resolution of the generated image.Options: 1k, 2k, 4kDefault: 2k
​
image_urls
array
Array of reference image URLs to guide the generation.Maximum: 4 imagesNote: Images must be publicly accessible URLs (JPEG, PNG, WebP).
​
camera_model_id
string
ID of the camera model setting from the Camera Settings endpoint.Applies the characteristics of a specific camera model to the generated image.
​
camera_lens_id
string
ID of the lens type setting from the Camera Settings endpoint.Affects the perspective, distortion, and optical qualities of the image.
​
camera_aperture_id
string
ID of the aperture setting from the Camera Settings endpoint.Controls depth of field and background blur (bokeh effect).
​
camera_focal_length_id
string
ID of the focal length setting from the Camera Settings endpoint.Affects field of view and perspective compression.
​
callback_url
string
URL to receive webhook notification on completion. See Callback documentation.

​
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 Settings

Use Camera Settings endpoint to browse available camera configurations

Reference Images

Provide up to 4 reference images for more controlled generation

Resolution

Use 4k for print-quality images, 2k for web, 1k for thumbnails

Detailed Prompts

Include lighting, composition, and style details in your prompt
Combine camera settings to achieve specific photographic styles - for example, use a wide aperture with a long focal length for portrait bokeh effects.