Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v2/generations \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data '{
       "model": "flux-kontext-max",
       "parameters": {
           "width": 1024,
           "height": 1024,
           "prompt": "A photo of an orange cat playing with a tennis ball, cinematic lighting",
           "quantity": 4,
           "style_ids": [
               "111dc692-d470-4eec-b791-3475abac4c46"
           ]
       },
       "public": false
   }'

API Request Endpoint, Headers, Parameters

Endpoint

https://cloud.leonardo.ai/api/rest/v2/generations

Headers

--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"

Body Parameters

Parameter	Type	Definition
guidances	`object`	Optional. Object defining image guidance inputs that influence the generated result.
guidances.image_reference	`array`	Optional. Image references (max 4) to guide your generation. Each entry includes `image.id`, `image.type` (`INIT`, `GENERATION`, `UPLOADED`, `GENERATED`, `VARIATION`), `strength` (`LOW`, `MID`, `HIGH`), and an optional `order`. `strength` defaults to `MID`.
height	`integer`	Optional. Height of the image to generate in pixels. Supports `32` to `2048`. Defaults to `1024`.
model	`string`	Required. Model identifier. Set to `flux-kontext-max`.
prompt	`string`	Required. Text prompt describing what image you want the model to generate. Must be `1` to `9999` characters.
prompt_enhance	`string`	Optional. Controls prompt enhancement. Accepts `AUTO`, `ON`, or `OFF`. Defaults to `AUTO`.
public	`boolean`	Optional. Boolean flag that determines whether the generation is public (`true`) or private (`false`).
quantity	`integer`	Optional. Number of images to generate in a single request. Supports `1` to `8`. Defaults to `4`.
seed	`integer`	Optional. Apply a fixed seed to maintain consistency across generation sets. Supports `0` to `4294967295`.
style_ids	`array`	Optional. Array of style UUIDs used to apply a preset style to the output (limited to 1). Refer to the table below. Defaults to `["111dc692-d470-4eec-b791-3475abac4c46"]` (Dynamic).
width	`integer`	Optional. Width of the image to generate in pixels. Supports `32` to `2048`. Defaults to `1024`.

List of Style IDs

Preset Style	UUID
3D Render	`debdf72a-91a4-467b-bf61-cc02bdeb69c6`
Acrylic	`3cbb655a-7ca4-463f-b697-8a03ad67327c`
Creative	`6fedbf1f-4a17-45ec-84fb-92fe524a29ef`
Dynamic	`111dc692-d470-4eec-b791-3475abac4c46`
Fashion	`594c4a08-a522-4e0e-b7ff-e4dac4b6b622`
Game Concept	`09d2b5b5-d7c5-4c02-905d-9f84051640f4`
Graphic Design 2D	`703d6fe5-7f1c-4a9e-8da0-5331f214d5cf`
Graphic Design 3D	`7d7c2bc5-4b12-4ac3-81a9-630057e9e89f`
Illustration	`645e4195-f63d-4715-a3f2-3fb1e6eb8c70`
None	`556c1ee5-ec38-42e8-955a-1e82dad0ffa1`
Portrait	`ab5a4220-7c42-41e5-a578-eddb9fed3d75`
Portrait Cinematic	`4edb03c9-8a26-4041-9d01-f85b5d4abd71`
Portrait Fashion	`0d34f8e1-46d4-428f-8ddd-4b11811fa7c9`
Pro B&W photography	`22a9a7d2-2166-4d86-80ff-22e2643adbcf`
Pro Color Photography	`7c3f932b-a572-47cb-9b9b-f20211e63b5b`
Pro Film Photography	`581ba6d6-5aac-4492-bebe-54c424a0d46e`
Ray Traced	`b504f83c-3326-4947-82e1-7fe9e839ec0f`
Stock Photo	`5bdc3f2a-1be6-4d1c-8e77-992a30824a2c`
Watercolor	`1db308ce-c7ad-4d10-96fd-592fa6b75cc4`