Leonardo.AI · Schema
Leonardo Lightning
Artificial IntelligenceImage GenerationVideo GenerationGenerative AICreative3DDiffusion ModelsCanva
Properties
| Name | Type | Description |
|---|---|---|
| model | string | Must be `lightning-xl`. |
| public | boolean | Whether the generated images should show in the community feed. |
| parameters | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/leonardo-ai/main/json-schema/leonardo-ai-lightning-xl-generation-request-schema.json",
"title": "Leonardo Lightning",
"x-generated": "2026-10-21",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/leonardo-ai-v2-api-openapi.yml#/components/schemas/LightningXlGenerationRequest",
"type": "object",
"required": [
"model"
],
"properties": {
"model": {
"type": "string",
"enum": [
"lightning-xl"
],
"description": "Must be `lightning-xl`."
},
"public": {
"type": "boolean",
"description": "Whether the generated images should show in the community feed."
},
"parameters": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"mode": {
"type": "string",
"title": "Generation Mode",
"pattern": "^[A-Z][A-Z0-9_]*[A-Z0-9]$",
"description": "Use this instead of `quality` for all proprietary models!",
"enum": [
"FAST",
"QUALITY"
],
"anyOf": [
{
"enum": [
"FAST"
]
},
{
"enum": [
"QUALITY"
]
}
],
"default": "FAST"
},
"seed": {
"type": "integer",
"title": "Seed",
"description": "The seed value for generation",
"minimum": 0
},
"width": {
"type": "integer",
"title": "Width",
"maximum": 1584,
"minimum": 32,
"description": "The width of the image to generate in pixels",
"default": 1024,
"multipleOf": 8
},
"height": {
"type": "integer",
"title": "Height",
"maximum": 1536,
"minimum": 32,
"description": "The height of the image to generate in pixels",
"default": 1024,
"multipleOf": 8
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 9999,
"minLength": 1,
"description": "The prompt to use for the generation"
},
"tiling": {
"type": "boolean",
"title": "Tiling"
},
"contrast": {
"enum": [
"LOW",
"MEDIUM",
"HIGH"
],
"type": "string",
"title": "Contrast",
"default": "MEDIUM",
"description": "The contrast the image should have"
},
"quantity": {
"type": "integer",
"title": "Quantity",
"minimum": 1,
"description": "The number of outputs to generate",
"default": 4,
"maximum": 8
},
"guidances": {
"type": "object",
"title": "Image guidance",
"description": "The image guidance properties object that will be defined on a per-model basis.",
"properties": {
"edge": {
"type": "array",
"items": {
"type": "object",
"title": "Edge to Image guidance",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Edge to Image guidance object — detects edges in the input image and uses them to guide generation"
},
"title": "Edge to Image",
"description": "Detects edges of any input image, and will use this to guide your image generation.",
"maxItems": 1
},
"pose": {
"type": "array",
"items": {
"type": "object",
"title": "Pose to Image guidance",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Pose to Image guidance object — detects the pose of characters in the input image and uses it to guide generation"
},
"title": "Pose to Image",
"description": "Detects the pose of any characters in an input image, and will use this to guide your image generation.",
"maxItems": 1
},
"depth": {
"type": "array",
"items": {
"type": "object",
"title": "Depth to Image guidance",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Depth to Image guidance — detects the depth features of the input image and uses them to guide generation"
},
"title": "Depth to Image",
"description": "Detects the depth features of any input image, and will use this to guide your image generation.",
"maxItems": 1
},
"style": {
"type": "array",
"items": {
"type": "object",
"title": "Style reference",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH",
"ULTRA",
"MAX"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Style transfer guidance object, containing parameters available for style transfer image guidance"
},
"title": "Style Reference",
"description": "References the style from the input image to guide your image generation.",
"maxItems": 4
},
"content": {
"type": "array",
"items": {
"type": "object",
"title": "Content reference",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH",
"ULTRA"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Content transfer guidance object, containing parameters available for content transfer image guidance"
},
"title": "Content Reference",
"description": "References the form and content from the input image to guide your image generation.",
"maxItems": 1
},
"character": {
"type": "array",
"items": {
"type": "object",
"title": "Character reference",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Character transfer guidance object, containing parameters available for character transfer image guidance"
},
"title": "Content Reference",
"description": "Generates an image in the likeness of the provided character reference image (works best with close up face portraits).",
"maxItems": 1
},
"text_image": {
"type": "array",
"items": {
"type": "object",
"title": "Text Image Input guidance",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"order": {
"type": "integer",
"title": "GuidanceOrder",
"minimum": 0,
"description": "The order at which we want this guidance to be in a list of guidances"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the guidance"
}
},
"description": "Text Image Input guidance — takes white text on a black background and uses it to guide image generation"
},
"title": "Text Image Input",
"description": "Takes in white text on a black background, and will use this to guide your image generation.",
"maxItems": 1
},
"image_to_image": {
"type": "array",
"items": {
"type": "object",
"title": "Image to image",
"required": [
"image",
"strength"
],
"properties": {
"image": {
"type": "object",
"allOf": [
{},
{}
],
"title": "Image reference",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL or a base64 data URL. Required when type is URL. The backend enriches resolved image URLs."
},
"data": {
"type": "string",
"description": "Base64-encoded image bytes. Required when type is BASE64.",
"format": "byte"
},
"type": {
"enum": [
"UPLOADED",
"GENERATED",
"VARIATION",
"URL",
"BASE64"
],
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"description": "A reference to an image"
},
"strength": {
"enum": [
"LOW",
"MID",
"HIGH"
],
"type": "string",
"default": "MID",
"description": "The strength of the image to image guidance"
}
},
"description": "Image to image guidance object, containing parameters available for image to image guidance"
},
"title": "Image to Image",
"description": "Creative reinterpretation of vibe or structure from a reference image.",
"maxItems": 1
}
}
},
"style_ids": {
"type": "array",
"items": {
"enum": [
"a5632c7c-ddbb-4e2f-ba34-8456ab3ac436",
"dee282d3-891f-4f73-ba02-7f8131e5541b",
"645e4195-f63d-4715-a3f2-3fb1e6eb8c70",
"6fedbf1f-4a17-45ec-84fb-92fe524a29ef",
"594c4a08-a522-4e0e-b7ff-e4dac4b6b622",
"5bdc3f2a-1be6-4d1c-8e77-992a30824a2c",
"ab5a4220-7c42-41e5-a578-eddb9fed3d75",
"debdf72a-91a4-467b-bf61-cc02bdeb69c6",
"b504f83c-3326-4947-82e1-7fe9e839ec0f",
"62736842-6e4b-4028-b79a-4f1a1606e893",
"6105baa2-851b-446e-9db5-08a671a8c42f",
"0d914779-c822-430a-b976-30075033f1c4",
"a2f7ea66-959b-4bbe-b508-6133238b76b6",
"621e1c9a-6319-4bee-a12d-ae40659162fa",
"cadc8cd6-7838-4c99-b645-df76be8ba8d8",
"d574325d-1278-4fe2-974b-768525f253c3",
"85da2dcc-c373-464c-9a7a-5624359be859",
"9fdc5e8c-4d13-49b4-9ce6-5a74cbb19177",
"be8c6b58-739c-4d44-b9c1-b032ed308b61",
"093accc3-7633-4ffd-82da-d34000dfc0d6",
"111dc692-d470-4eec-b791-3475abac4c46",
"556c1ee5-ec38-42e8-955a-1e82dad0ffa1"
],
"type": "string",
"format": "uuid"
},
"title": "Style IDs for Image Models",
"default": [
"111dc692-d470-4eec-b791-3475abac4c46"
],
"description": "An array of style UUIDs for image models (limited to 1 style)."
},
"transparency": {
"type": "boolean",
"title": "Transparency",
"description": "Whether the image can be generated with a transparent background",
"default": false
},
"user_elements": {
"type": "array",
"items": {
"properties": {
"weight": {
"minimum": 0
}
}
},
"title": "Your Elements",
"default": [],
"description": "An array of User Elements for image generation.",
"maxItems": 4
},
"prompt_enhance": {
"enum": [
"AUTO",
"ON",
"OFF"
],
"type": "string",
"title": "Prompt Enhance",
"default": "OFF",
"description": "Whether to enhance the prompt or not"
},
"negative_prompt": {
"type": "string",
"title": "Negative Prompt",
"maxLength": 1000,
"description": "The negative prompt to use for the generation"
},
"platform_elements": {
"type": "array",
"items": {
"properties": {
"weight": {
"minimum": 0
}
}
},
"title": "Platform Elements",
"default": [],
"description": "An array of Platform Elements for image generation.",
"maxItems": 4
}
}
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/leonardo-ai-lightning-xl-generation-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.