---
title: "List ready-made characters"
method: GET
path: "/personas/presets"
tags: ["Personas"]
---

# List ready-made characters

`GET /personas/presets`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/personas/presets`
- Auth: API key in header `X-Api-Key`

Characters whose photo already exists. `POST /personas/presets/{presetId}` turns one into a persona for free, ready to name, save and use in videos. `favorite` is the key's user's star, set with `PUT /personas/presets/{presetId}/favorite`.

## Response `200`

Response for status 200

- object
  - `presets` object[], required
    - `id` string, required
    - `name` string, required
    - `category` 'weird' | 'cartoon' | 'creator' | 'influencers', required: `weird`, `cartoon` (live-action takes on cartoon looks), `creator` (everyday creators) or `influencers` (influencer personas).
    - `favorite` boolean, required
    - `favorite_count` number, required: How many users starred this character.
    - `image_url` string, nullable, required: Signed URL of the character photo (close-up and full body), valid for one hour.
    - `face_url` string, nullable, required: Signed URL of the close-up portrait, valid for one hour.

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)