How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Leonardo.AI Image API

The Image API from Leonardo.AI — 3 operation(s) for image.

Leonardo.AI Image API is one of 14 APIs that Leonardo.AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Image. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, an AsyncAPI specification, a JSON-LD context, and 2 JSON Schemas.

This API exposes 4 operations across 3 paths, and defines 35 schemas. It is described by OpenAPI 3.0.0, at version v1.0.0.

Requests are made against a single base URL, https://cloud.leonardo.ai/api/rest/v1.

4 operations 3 paths 35 schemas 1 DELETE2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v1.0.0
Server
https://cloud.leonardo.ai/api/rest/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Leonardo.AI Image API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (auth-scheme) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer HTTP authentication. Allowed headers Authorization: Bearer

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 1 DELETE, 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Image 4
POST
/generations
Create a Generation of Images
createGeneration body → 200
GET
/generations/{id}
Get a Single Generation
getGenerationById 1 param → 200
DELETE
/generations/{id}
Delete a Single Generation
deleteGenerationById 1 param → 200
GET
/generations/user/{userId}
Get generations by user ID
getGenerationsByUserId 3 params → 200

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are lora (7 properties), controlnet_input (5 properties), user_elements_input (2 properties), element_input (2 properties). Each schema is shown below with its type and property counts.

promptMagicRes
boolean
If prompt magic was used.
lora
object
7 properties
motion
boolean
If generation is of motion type.
imageToVideo
boolean
If it is an image to video generation.
VARIATION_TYPE
string
The type of variation.
sd_versions
string
The base version of stable diffusion to use if not using a custom model. v15 is 1.5, v2 is 2.1, if not specified it will default to v15. Also includes SDXL and…
timestamp
string
bigint
integer
photoRealStrengthRes
number
Depth of field of photoReal used. 0.55 is low, 0.5 is medium, and 0.45 is high. Default is 0.55.
motionStrength
integer
The motion strength.
job_status
string
The status of the current task.
promptMagicVersionArg
string
Prompt magic version v2 or v3, for use when promptMagic: true
element_input
object
2 properties 1 required
seed
integer
Apply a fixed seed to maintain consistency across generation sets. The maximum seed value is 2147483637 for Flux and 9999999998 for other models
photoRealStrengthArg
number
Depth of field of photoReal. Must be 0.55 for low, 0.5 for medium, or 0.45 for high. Defaults to 0.55 if not specified.
promptMagicVersionRes
string
Version of prompt magic used.
canvasRequestType
string
The type of request for the Canvas Editor.
controlnet_type
string
This parameter will be deprecated in September 2024. Please use the controlnets array instead.
motionMP4URL
string
The URL of the motion MP4.
promptMagicStrengthArg
number
Strength of prompt magic. Must be a float between 0.1 and 1.0
cost
object
The cost of the operation.
2 properties
uuid
string
photoRealRes
boolean
If photoReal feature was used.
sd_generation_schedulers
string
The scheduler to generate images with. Defaults to EULERDISCRETE if not specified.
promptMagicArg
boolean
Enable to use Prompt Magic.
promptMagicStrengthRes
number
Strength of prompt magic used.
numeric
number
controlnet_input
object
5 properties
float8
number
sd_generation_ultra
boolean
If ultra generation mode was used.
user_elements_input
object
2 properties
photoRealVersion
string
The version of photoReal to use. Must be v1 or v2.
sd_generation_style
string
The style to generate images with. When photoReal is enabled, refer to the Guide section for a full list. When alchemy is disabled, use LEONARDO or NONE. When…
photoRealArg
boolean
Enable the photoReal feature. Requires enabling alchemy and unspecifying modelId (for photoRealVersion V1).
motionModel
string
The name of the motion model.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

leonardo-ai-image-api-openapi.yml Raw ↑

Other APIs Leonardo.AI publishes across the network.

Leonardo.AI 3D Model Assets API
Leonardo.AI Blueprints API
Leonardo.AI Dataset API
Leonardo.AI Elements API
Leonardo.AI Init Images API
Leonardo.AI Media API
Leonardo.AI Models API
Leonardo.AI Motion API
Leonardo.AI Pricing Calculator API
Leonardo.AI Prompt API
Leonardo.AI Realtime Canvas API
Leonardo.AI User API
Where this information came from

This is an independent, third-party profile of Leonardo.AI Image API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.