---
title: "LoRAs training for custom characters"
method: POST
path: "/v1/ai/loras/characters"
tags: ["loras"]
---

# LoRAs training for custom characters

`POST /v1/ai/loras/characters`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/loras/characters`
- Auth: API key in header `x-magnific-api-key`

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

## Request body

- LorasCharacterRequest
  - `name` string, required: Name of the LoRA character. This name will be used to identify the style in the system.
  - `description` string: Description of the LoRA character
  - `quality` 'high' | 'ultra', required: Quality of the LoRA character
  - `gender` 'male' | 'female' | 'neutral' | 'custom', required
  - `images` string[], required: List of images to train the LoRA character
  - `webhook_url` string, uri: Webhook URL to notify the user when the task is completed

## Response `200`

OK - The request has succeeded and the character is processing

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)