Freepik Loras API

The loras API from Freepik — 3 operation(s) for loras.

Operations 3

GET /v1/ai/loras Get available loras list #
POST /v1/ai/loras/styles Mystic LoRA Styles - Train custom style #
POST /v1/ai/loras/characters LoRAs training for custom characters #

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/freepik:freepik-loras-api"
All apis
curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

freepik-loras-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world.
  title: Magnific Loras API
  version: 1.0.0
servers:
- description: B2B API Production V1
  url: https://api.magnific.com
security:
- magnificApiKey: []
tags:
- name: loras
paths:
  /v1/ai/loras:
    get:
      operationId: get_available_loras_list
      responses:
        '200':
          content:
            application/json:
              examples:
                success:
                  $ref: '#/components/examples/200-loras'
              schema:
                $ref: '#/components/schemas/get_available_loras_list_200_response'
          description: OK
        '500':
          $ref: '#/components/responses/500-internal-server-error'
        '503':
          $ref: '#/components/responses/503-service-unavailable'
      tags:
      - loras
      summary: Get available loras list
      x-summary-source: derived
  /v1/ai/loras/styles:
    post:
      description: 'Create you own custom style using LoRAs training


        For now you can check the status of the training calling `v1/ai/loras`. We are working on it'
      requestBody:
        content:
          application/json:
            examples:
              characters-request:
                $ref: '#/components/examples/request-loras-styles'
            schema:
              $ref: '#/components/schemas/loras-style-request'
      responses:
        '200':
          content:
            application/json:
              examples:
                success - in progress task:
                  $ref: '#/components/examples/200-task-in-progress'
              schema:
                $ref: '#/components/schemas/get_style_transfer_task_status_200_response'
          description: OK - The request has succeeded and the style is processing
        '400':
          $ref: '#/components/responses/400-bad-request'
        '401':
          $ref: '#/components/responses/401-unauthorized'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
        '503':
          $ref: '#/components/responses/503-service-unavailable'
      summary: Mystic LoRA Styles - Train custom style
      tags:
      - loras
      operationId: postV1AiLorasStyles
      x-operation-id-source: derived
  /v1/ai/loras/characters:
    post:
      description: 'Create you own custom character using LoRAs training


        For now you can check the status of the training calling `v1/ai/loras`. We are working on it'
      requestBody:
        content:
          application/json:
            examples:
              characters-request:
                $ref: '#/components/examples/request-loras-characters'
            schema:
              $ref: '#/components/schemas/loras-character-request'
      responses:
        '200':
          content:
            application/json:
              examples:
                success - in progress task:
                  $ref: '#/components/examples/200-task-in-progress'
              schema:
                $ref: '#/components/schemas/get_style_transfer_task_status_200_response'
          description: OK - The request has succeeded and the character is processing
        '400':
          $ref: '#/components/responses/400-bad-request'
        '401':
          $ref: '#/components/responses/401-unauthorized'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
        '503':
          $ref: '#/components/responses/503-service-unavailable'
      summary: LoRAs training for custom characters
      tags:
      - loras
      operationId: postV1AiLorasCharacters
      x-operation-id-source: derived
components:
  examples:
    request-loras-styles:
      summary: Request - LoRAs styles training
      value:
        name: my-awesome-style
        description: string
        quality: high
        images:
        - string
        - string
        - string
        - string
        - string
        - string
        - string
        - string
        webhook_url: https://my-webhook-url.com/endpoint
    200-task-in-progress:
      summary: Success - Task in progress
      value:
        data:
          generated: []
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: IN_PROGRESS
    request-loras-characters:
      summary: Request - LoRAs characters training
      value:
        name: my-awesome-character
        description: string
        quality: high
        gender: male
        images:
        - string
        - string
        - string
        - string
        - string
        - string
        - string
        - string
        webhook_url: https://my-webhook-url.com/endpoint
    200-loras:
      summary: Loras response
      value:
        data:
          default:
          - id: 1
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            category: illustration
            type: style
            preview: https://example.com/vintage-japanese-preview.jpg
            training:
              status: completed
              defaultScale: 1.2
          - id: 2
            name: sara
            description: sara
            category: people
            type: character
            preview: https://example.com/sara-preview.jpg
            training:
              status: completed
              defaultScale: 1.2
          - id: 3
            name: glasses
            description: glasses
            category: glasses
            type: product
            preview: https://example.com/glasses-preview.jpg
            training:
              status: completed
              defaultScale: 1.2
          customs:
          - id: 110
            name: sara
            description: ''
            category: photography
            type: character
            preview: https://example.com/sara-preview.jpg
            training:
              status: completed
              defaultScale: 1
              quality: null
  responses:
    401-unauthorized:
      content:
        application/json:
          examples:
            invalid_api_key:
              summary: API key is not valid
              value:
                message: Invalid API key
            missing_api_key:
              summary: API key is not provided
              value:
                message: Missing API key
          schema:
            $ref: '#/components/schemas/inline_object'
      description: Unauthorized - The client must authenticate itself to get the requested response.
    503-service-unavailable:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/inline_object_3'
      description: Service Unavailable
    400-bad-request:
      content:
        application/json:
          examples:
            invalid_page:
              summary: Parameter 'page' is not valid
              value:
                message: Parameter 'page' must be greater than 0
            invalid_query:
              summary: Parameter 'query' is not valid
              value:
                message: Parameter 'query' must not be empty
            invalid_filter:
              summary: Parameter 'filter' is not valid
              value:
                message: Parameter 'filter' is not valid
            generic_bad_request:
              summary: Bad Request
              value:
                message: Parameter ':attribute' is not valid
          schema:
            $ref: '#/components/schemas/inline_object'
        application/problem+json:
          examples:
            invalid_page:
              summary: Parameter 'page' is not valid
              value:
                message: Validation error
                invalid_params:
                - field: page
                  reason: Parameter 'page' must be greater than 0
                - field: per_page
                  reason: Parameter 'per_page' must be greater than 0
          schema:
            $ref: '#/components/schemas/inline_object_1'
      description: Bad Request - The server could not understand the request due to invalid syntax.
    500-internal-server-error:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/inline_object_2'
      description: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
  schemas:
    get_available_loras_list_200_response:
      example:
        data:
        - default:
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          customs:
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
        - default:
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          customs:
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
          - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
            name: vintage-japanese
            description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
            training:
              defaultScale: 1.2
              status: status
              quality: quality
            id: 1
            category: illustration
            type: character
      properties:
        data:
          items:
            $ref: '#/components/schemas/loras-list'
          type: array
      type: object
    inline_object_1_problem_invalid_params_inner:
      properties:
        name:
          description: Name of the invalid parameter.
          example: page
          type: string
        field:
          description: Field of the invalid parameter. Mirrors `name`.
          example: page
          type: string
        reason:
          example: Parameter 'page' must be greater than 0
          type: string
      required:
      - field
      - name
      - reason
      type: object
    lora-item:
      example:
        preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
        name: vintage-japanese
        description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
        training:
          defaultScale: 1.2
          status: status
          quality: quality
        id: 1
        category: illustration
        type: character
      properties:
        id:
          description: Lora ID
          example: 1
          minimum: 1
          type: integer
        name:
          description: Lora name
          example: vintage-japanese
          type: string
        description:
          description: Lora description
          example: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
          type:
          - string
          - 'null'
        category:
          description: Lora category
          example: illustration
          type: string
        type:
          description: Lora type
          example: character
          type: string
        preview:
          description: Preview image URL for the Lora
          example: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
          format: uri
          type: string
        training:
          $ref: '#/components/schemas/lora_item_training'
      required:
      - category
      - description
      - id
      - name
      - preview
      - training
      - type
      type: object
    task:
      example:
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
      properties:
        task_id:
          description: Task identifier
          format: uuid
          type: string
        status:
          description: Task status
          enum:
          - CREATED
          - IN_PROGRESS
          - COMPLETED
          - FAILED
          type: string
      required:
      - status
      - task_id
      type: object
    loras-character-request:
      properties:
        name:
          description: Name of the LoRA character. This name will be used to identify the style in the system.
          pattern: ^[a-zA-Z0-9-_]+$
          type: string
        description:
          description: Description of the LoRA character
          type: string
        quality:
          description: Quality of the LoRA character
          enum:
          - high
          - ultra
          type: string
        gender:
          enum:
          - male
          - female
          - neutral
          - custom
          type: string
        images:
          description: List of images to train the LoRA character
          items:
            description: Url of the image to train the LoRA character
            format: uri
            type: string
          maxItems: 20
          minItems: 8
          type: array
        webhook_url:
          description: Webhook URL to notify the user when the task is completed
          format: uri
          type: string
      required:
      - gender
      - images
      - name
      - quality
      type: object
    loras-list:
      example:
        default:
        - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
          name: vintage-japanese
          description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
          training:
            defaultScale: 1.2
            status: status
            quality: quality
          id: 1
          category: illustration
          type: character
        - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
          name: vintage-japanese
          description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
          training:
            defaultScale: 1.2
            status: status
            quality: quality
          id: 1
          category: illustration
          type: character
        customs:
        - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
          name: vintage-japanese
          description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
          training:
            defaultScale: 1.2
            status: status
            quality: quality
          id: 1
          category: illustration
          type: character
        - preview: https://www.example.com/4fef9987-75d0-44d1-b336-65f42f883bff.png
          name: vintage-japanese
          description: Expect bold red colors and a sense of nostalgia, bringing to life classic Japanese elements.
          training:
            defaultScale: 1.2
            status: status
            quality: quality
          id: 1
          category: illustration
          type: character
      properties:
        default:
          description: List of default Loras
          items:
            $ref: '#/components/schemas/lora-item'
          type: array
        customs:
          description: List of custom Loras
          items:
            $ref: '#/components/schemas/lora-item'
          type: array
      type: object
    inline_object_1:
      properties:
        problem:
          $ref: '#/components/schemas/inline_object_1_problem'
      type: object
    inline_object_1_problem:
      properties:
        message:
          example: Validation error
          type: string
        invalid_params:
          items:
            $ref: '#/components/schemas/inline_object_1_problem_invalid_params_inner'
          type: array
      required:
      - invalid_params
      - message
      type: object
    inline_object_2:
      example:
        message: Internal Server Error
      properties:
        message:
          example: Internal Server Error
          type: string
      type: object
    inline_object:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    get_style_transfer_task_status_200_response:
      example:
        data:
          generated:
          - https://openapi-generator.tech
          - https://openapi-generator.tech
          task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          status: CREATED
      properties:
        data:
          $ref: '#/components/schemas/task-detail'
      required:
      - data
      type: object
    task-detail:
      allOf:
      - $ref: '#/components/schemas/task'
      - properties:
          generated:
            items:
              description: URL of the generated image
              format: uri
              type: string
            type: array
        required:
        - generated
        type: object
      example:
        generated:
        - https://openapi-generator.tech
        - https://openapi-generator.tech
        task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        status: CREATED
    inline_object_3:
      example:
        message: Service Unavailable. Please try again later.
      properties:
        message:
          example: Service Unavailable. Please try again later.
          type: string
      type: object
    lora_item_training:
      example:
        defaultScale: 1.2
        status: status
        quality: quality
      properties:
        status:
          description: Training status
          type: string
        defaultScale:
          description: Default scale
          example: 1.2
          type: number
        quality:
          description: Training quality
          type:
          - string
          - 'null'
      type: object
    loras-style-request:
      properties:
        name:
          description: Name of the LoRA style. This name will be used to identify the style in the system.
          pattern: ^[a-zA-Z0-9-_]+$
          type: string
        description:
          description: Description of the LoRA style
          type: string
        quality:
          description: Quality of the LoRA style
          enum:
          - medium
          - high
          - ultra
          type: string
        images:
          description: List of images to train the LoRA style
          items:
            description: Url of the image to train the LoRA style
            format: uri
            type: string
          maxItems: 20
          minItems: 6
          type: array
        webhook_url:
          description: Webhook URL to notify the user when the task is completed
          format: uri
          type: string
      required:
      - images
      - name
      - quality
      type: object
  securitySchemes:
    magnificApiKey:
      description: 'Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart)

        '
      in: header
      name: x-magnific-api-key
      type: apiKey
x-provenance:
  method: harvested
  publisher: Freepik
  source: https://storage.googleapis.com/fc-freepik-pro-rev1-eu-api-specs/magnific-api-v1-openapi.yaml?v=46\
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)