Skip to main content
POST
Error

Authorizations

x-api-key
string
header
required

Organisation API key. Format: sk_<secret>/<keyname> — the secret portion, a literal slash, and the human-readable key name. The header exulu-api-key is accepted as an alias. A Bearer prefix is tolerated and stripped. Keys with an agent scope are only valid for the scoped agent instance.

Body

application/json
sessionId
string<uuid>
required

Session to associate the generated images with.

toolCallId
string
required

Tool call ID linking this generation to a specific tool invocation.

model
string
required

Model name as listed in config.litellm.yaml with model_info.type: image_generation.

prompt
string
required

Text prompt to generate images from.

n
integer

Number of images to generate. Must not exceed the model's max_n limit.

Required range: x >= 1
size
string

Image dimensions (e.g. 1024x1024). Must be a value supported by the chosen model.

quality
string

Generation quality level (e.g. standard, hd). Must be supported by the chosen model.

styleId
string

Optional ID of a saved style (platform_configurations row). Its markdown content is appended to the prompt.

Response

Generated images.

generationId
string
required

ID of the image_generations row.

images
object[]
required