Leonardo.AI

Leonardo.AI Elements API

The Elements API from Leonardo.AI — 3 operation(s) for elements.

Documentation GitHub OpenAPI

Business capability

Artificial Intelligence Management BC-610.60

Operations 5

GET /elements/{id} Get a Single Custom Element by ID #

DELETE /elements/{id} Delete a Single Custom Element by ID #

GET /elements/user/{userId} Get a list of Custom Elements by User ID #

POST /elements Train a Custom Element #

GET /elements List Elements #

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/leonardo-ai:leonardo-ai-elements-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Leonardo.AI Elements API
  description: Create and manage Custom Elements — LoRA-style style adapters trainable on user datasets and reusable across image generations.
  version: v1.0.0
  contact:
    name: Leonardo.AI Support
    url: https://docs.leonardo.ai/docs/need-more-support
  license:
    name: Leonardo.AI Terms of Service
    url: https://leonardo.ai/terms-of-service/
servers:
- url: https://cloud.leonardo.ai/api/rest/v1
  description: Leonardo.AI Production API
security:
- bearerAuth: []
tags:
- name: Elements
paths:
  /elements/{id}:
    get:
      tags:
      - Elements
      summary: Get a Single Custom Element by ID
      description: This endpoint gets the specific custom element.
      operationId: getElementById
      parameters:
      - required: true
        description: The ID of the custom element to return.
        in: path
        name: id
        schema:
          pattern: '[0-9]{*}'
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  user_loras_by_pk:
                    description: columns and relationships of "user_loras".
                    properties:
                      createdAt:
                        $ref: '#/components/schemas/timestamp'
                      description:
                        title: String
                        type: string
                      id:
                        title: Int
                        type: integer
                      instancePrompt:
                        title: String
                        type:
                        - string
                        - 'null'
                      resolution:
                        title: Int
                        type: integer
                      learningRate:
                        title: Float
                        type: number
                      trainingEpoch:
                        title: Int
                        type: integer
                      name:
                        title: String
                        type: string
                      trainTextEncoder:
                        title: Boolean
                        type: boolean
                      baseModel:
                        title: String
                        type: string
                      status:
                        $ref: '#/components/schemas/job_status'
                      focus:
                        title: String
                        type: string
                      updatedAt:
                        $ref: '#/components/schemas/timestamp'
                    title: user_loras
                    type:
                    - object
                    - 'null'
          description: Responses for GET /elements/{id}.
    delete:
      tags:
      - Elements
      summary: Delete a Single Custom Element by ID
      description: This endpoint will delete a specific custom model.
      operationId: deleteElementById
      parameters:
      - required: true
        description: The ID of the element to delete.
        in: path
        name: id
        schema:
          pattern: '[0-9]{*}'
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  delete_user_loras_by_pk:
                    description: columns and relationships of "user_loras".
                    properties:
                      id:
                        title: Int
                        type: integer
                    title: user_loras
                    type:
                    - object
                    - 'null'
          description: Responses for DELETE /models/{id}
  /elements/user/{userId}:
    get:
      tags:
      - Elements
      summary: Get a list of Custom Elements by User ID
      description: This endpoint gets the list of custom elements belongs to the user.
      operationId: getCustomElementsByUserId
      parameters:
      - required: true
        description: The ID of the user to return.
        in: path
        name: userId
        schema:
          pattern: '[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89aAbB][a-f0-9]{3}-[a-f0-9]{12}'
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  user_loras:
                    items:
                      description: columns and relationships of "user_loras".
                      title: user_loras
                      type:
                      - object
                      - 'null'
                      properties:
                        createdAt:
                          $ref: '#/components/schemas/timestamp'
                        description:
                          title: String
                          type: string
                        id:
                          title: Int
                          type: integer
                        instancePrompt:
                          title: String
                          type:
                          - string
                          - 'null'
                        resolution:
                          title: Int
                          type: integer
                        learningRate:
                          title: Float
                          type: number
                        trainingEpoch:
                          title: Int
                          type: integer
                        name:
                          title: String
                          type: string
                        trainTextEncoder:
                          title: Boolean
                          type: boolean
                        baseModel:
                          title: String
                          type: string
                        status:
                          $ref: '#/components/schemas/job_status'
                        focus:
                          title: String
                          type: string
                        updatedAt:
                          $ref: '#/components/schemas/timestamp'
                    type:
                    - array
                    - 'null'
          description: Responses for GET /elements/user/{userId}.
  /elements:
    post:
      tags:
      - Elements
      summary: Train a Custom Element
      description: This endpoint will train a new custom element.
      operationId: createElement
      requestBody:
        content:
          application/json:
            schema:
              properties:
                name:
                  default: placeholder
                  title: String
                  type: string
                  description: The name of the element.
                description:
                  default: ''
                  title: String
                  type:
                  - string
                  - 'null'
                  description: The description of the element.
                datasetId:
                  default: ''
                  title: String
                  type: string
                  description: The ID of the dataset to train the element on.
                instance_prompt:
                  default: ''
                  title: String
                  type:
                  - string
                  - 'null'
                  description: Use a word that is closely related to what you're training that isn't too common. For example, instead of 'dog,' try something unique like 'jackthedog' or 'magicdonut'. Required for all non-FLUX_DEV models and FLUX_DEV Character model training.
                lora_focus:
                  title: String
                  type: string
                  description: The category determines how the element will be trained. Options are 'General' | 'Character' | 'Style' | 'Object'. FLUX_DEV doesn't support General category.
                train_text_encoder:
                  default: true
                  title: Boolean
                  type: boolean
                  description: Whether or not encode the train text.
                resolution:
                  default: 1024
                  title: Int
                  type:
                  - integer
                  - 'null'
                  description: The resolution for training. Must be 1024.
                sd_version:
                  default: FLUX_DEV
                  title: sd_versions
                  enum:
                  - SDXL_0_9
                  - SDXL_1_0
                  - LEONARDO_DIFFUSION_XL
                  - LEONARDO_LIGHTNING_XL
                  - VISION_XL
                  - KINO_XL
                  - ALBEDO_XL
                  - FLUX_DEV
                  description: The base version to use if not using a custom model.
                num_train_epochs:
                  title: Int
                  type: integer
                  description: The number of times the entire training dataset is passed through the element.<br><br><table><tr><th>Model Type</th><th>Lora Focus</th><th>Min</th><th>Max</th><th>Default</th></tr><tr><td>Default</td><td>General | Style | Character | Object</td><td>1</td><td>250</td><td>100</td></tr><tr><td rowspan='3'>FLUX_DEV</td><td>Style</td><td>30</td><td>120</td><td>60</td></tr><tr><td>Object</td><td>120</td><td>220</td><td>140</td></tr><tr><td>Character</td><td>100</td><td>200</td><td>135</td></tr><tr><td>General</td><td colspan='3'>NA</td></tr></table>
                learning_rate:
                  title: Float
                  type: number
                  description: The speed at which the model learns during training.<br><br><table><tr><th>Model Type</th><th>Lora Focus</th><th>Min</th><th>Max</th><th>Default</th></tr><tr><td>Default</td><td>General | Style | Character | Object</td><td>0.00000001</td><td>0.00001</td><td>0.000001</td></tr><tr><td rowspan='3'>FLUX_DEV</td><td>Style</td><td>0.000001</td><td>0.00003</td><td>0.00001</td></tr><tr><td>Object</td><td>0.00001</td><td>0.001</td><td>0.0004</td></tr><tr><td>Character</td><td>0.00001</td><td>0.001</td><td>0.0005</td></tr><tr><td>General</td><td colspan='3'>NA</td></tr></table>
              required:
              - name
              - datasetId
              - lora_focus
              - sd_version
              - learning_rate
              - num_train_epochs
              - train_text_encoder
              type: object
        description: Query parameters to be provided in the request body as a JSON object.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  sdTrainingJob:
                    properties:
                      userLoraId:
                        title: Int
                        type: integer
                      apiCreditCost:
                        type:
                        - integer
                        - 'null'
                        description: 'API Credits Cost for Model Training. Available for Production API Users. Note: it will be deprecated. Please use the cost instead.'
                        deprecated: true
                      cost:
                        $ref: '#/components/schemas/cost'
                    title: SDTrainingOutput
                    type:
                    - object
                    - 'null'
              example:
                sdTrainingJob:
                  userLoraId: 123456
                  apiCreditCost: null
                  cost:
                    amount: '0.0147'
                    unit: DOLLARS
          description: Responses for POST /elements.
    get:
      tags:
      - Elements
      summary: List Elements
      description: Get a list of public Elements available for use with generations.
      operationId: listElements
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  loras:
                    items:
                      description: columns and relationships of "elements".
                      properties:
                        akUUID:
                          $ref: '#/components/schemas/lora/properties/akUUID'
                        baseModel:
                          $ref: '#/components/schemas/sd_versions'
                        creatorName:
                          $ref: '#/components/schemas/lora/properties/creatorName'
                        description:
                          $ref: '#/components/schemas/lora/properties/description'
                        name:
                          $ref: '#/components/schemas/lora/properties/name'
                        urlImage:
                          $ref: '#/components/schemas/lora/properties/urlImage'
                        weightDefault:
                          $ref: '#/components/schemas/lora/properties/weightDefault'
                        weightMax:
                          $ref: '#/components/schemas/lora/properties/weightMax'
                        weightMin:
                          $ref: '#/components/schemas/lora/properties/weightMin'
                      title: loras
                      type: object
                    type: array
          description: Responses for GET /api/rest/v1/elements.
components:
  schemas:
    lora:
      type: object
      properties:
        akUUID:
          type:
          - string
          - 'null'
          description: Unique identifier for the element. Elements can be found from the List Elements endpoint.
        creatorName:
          type:
          - string
          - 'null'
          description: Name of the creator of the element
        name:
          type:
          - string
          - 'null'
          description: Name of the element
        description:
          type:
          - string
          - 'null'
          description: Description for the element
        urlImage:
          type:
          - string
          - 'null'
          description: URL of the element image
        baseModel:
          type:
          - string
          - 'null'
          description: Base model version for the element
        weightDefault:
          type:
          - integer
          - 'null'
          description: Default weight for the element
        weightMin:
          type:
          - integer
          - 'null'
          description: Minimum weight for the element
        weightMax:
          type:
          - integer
          - 'null'
          description: Maximum weight for the element
        __typename:
          type: string
          description: Type name for introspection purposes
    timestamp:
      type: string
      title: timestamp
    cost:
      type:
      - object
      - 'null'
      title: Cost
      description: The cost of the operation.
      properties:
        amount:
          type: string
          description: The amount of the cost.
        unit:
          type: string
          enum:
          - CREDITS
          - DOLLARS
          description: 'The unit of the cost. Can be CREDITS or DOLLARS. Note: DOLLARS unit only supports PAYG plan.'
    sd_versions:
      type: string
      title: sd_versions
      enum:
      - v1_5
      - v2
      - v3
      - SDXL_0_8
      - SDXL_0_9
      - SDXL_1_0
      - SDXL_LIGHTNING
      - PHOENIX
      - FLUX
      - FLUX_DEV
      - KINO_2_0
      description: The base version of stable diffusion to use if not using a custom model. v1_5 is 1.5, v2 is 2.1, if not specified it will default to v1_5. Also includes SDXL and SDXL Lightning models
    job_status:
      type: string
      title: job_status
      enum:
      - PENDING
      - COMPLETE
      - FAILED
      description: The status of the current task.
  securitySchemes:
    bearerAuth:
      type: http
      bearerFormat: auth-scheme
      description: 'Bearer HTTP authentication. Allowed headers `Authorization: Bearer <api_key>`'
      scheme: bearer

Leonardo.AI Elements API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources