> ## Documentation Index
> Fetch the complete documentation index at: https://help.onlyx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> You are reading OnlyX Help: the OnlyX Help Center and the OnlyX developer documentation. OnlyX is an AI chatting and CRM platform for OnlyFans agencies. Its AI chatter is called Hugo in the app.
> Pages at the site root (for example /inbox/..., /hugo/..., /billing/...) are Help Center articles for agency owners, admins, chatters and creators who use the app at app.onlyx.ai. Words in bold are the exact button, menu and label names the app shows; keep them exactly as written. When these pages do not answer a question, the person can email support at support@onlyx.ai.
> Pages under /developers are the developer documentation. REST API base URL: https://api.onlyx.ai/v1 (authenticate with `Authorization: Bearer <API key>`; keys start with onx_sk_ and are created in app.onlyx.ai under Settings > API & MCP). MCP server: https://mcp.onlyx.ai/mcp (OAuth, or a Bearer API key). In the API the AI chatter is `ai` on the wire. Money is integer US cents in fields ending in Cents; timestamps are UTC ISO-8601.
> Rules for assistants acting on a user's behalf: discover ids with list calls and never invent them; before any call that reaches a real fan or the live OnlyFans account (sending a message, releasing a chat to the AI, turning AI on for a chat, resolving a hand-off, turning review mode off, changing the welcome message, creating a tracking link) show the user the exact content and get explicit confirmation; send every POST with an Idempotency-Key and reuse it on retry; never resend a message whose delivery status is unconfirmed; never ask a creator for her OnlyFans password or codes - she signs in herself through a connect link and the OnlyX Login app.

# How AI Content works: groups, collections and levels

> Learn how AI Content decides what Hugo can sell: groups, collections, levels, teasers, paid pieces and price floors.

<Badge color="purple">Owners, admins and content VAs</Badge>

Hugo sells only what you map on a creator's AI Content tab. This page explains how that map is built, so you can set it up with confidence.

## What AI Content does

* Hugo sells from AI Content and from nothing else. He never makes up content.
* Hugo never sells a whole level for less than the price floor you set for it. If he sells only some of a level's files, he may price that part in proportion to the floor. See [Set price floors and tags](/ai-content/prices-and-tags).
* Hugo answers fans whether AI Content is built or not. Without it, he has nothing to sell.
* Mapping content posts nothing and sends nothing. It only tells Hugo which files he may sell, how they are bundled, and the price floor for each bundle. Mapping alone never shows a file to any fan.
* Each creator has her own AI Content.

Hugo starts answering a creator's fans when Hugo is on and her setup is done:

* her account is connected;
* her persona has an age and a backstory;
* her hard limits are saved;
* at least one fan has synced.

AI Content is what lets him sell.

One level must be active, have a price and hold files. Then the setup step **Map the content** on her **Overview** is ticked and marked **Done**. See [Get a creator ready for Hugo](/hugo/setup-checklist).

## Where to find it

Open the creator's page. In her menu, under **Hugo**, click **AI Content**.

You can also start from the setup step **Map the content** on her **Overview**: click **Open AI Content**. In the Inbox, the fan panel has an AI Content part with a **Manage** link to the same place.

<Frame caption="**1** Groups and collections · **2** The levels of the open collection · **3** The vault">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/board-tour-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=4b65101a887e770f46fdc6979d909d95" alt="The AI Content board: collections grouped in a list, the levels of the open collection in the middle and the Vault strip next to them" width="1600" height="939" data-path="images/help/ai-content/how-ai-content-works/board-tour-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/board-tour-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=9242610a1df07402faf911157777a3eb" alt="The AI Content board: collections grouped in a list, the levels of the open collection in the middle and the Vault strip next to them" width="1600" height="939" data-path="images/help/ai-content/how-ai-content-works/board-tour-dark.png" />
</Frame>

On a computer, the board has three parts:

1. The collection list, with your groups as headings. A coloured dot next to each collection shows whether any of its levels needs work.
2. The ladder: the levels of the collection you opened, with L1 first.
3. The vault. Click the **Vault** strip to open it next to the ladder.

A phone, or a browser window narrower than 1,024 pixels, shows a simpler board. The collections are a row of buttons at the top, and the vault opens as a picker.

## The parts of AI Content

| Part | What it is | What Hugo does with it |
| - | - | - |
| Group | A heading in your collection list, to keep it tidy. Optional. | Nothing. The app says: "A heading in the list. Hugo never reads it." |
| Collection | One theme or one shoot, such as "Shower". It holds levels. | He uses its name when he talks about it. He reads its About to decide when it fits a fan. |
| Level (L1, L2 and so on) | One bundle Hugo can offer: its files, a name and a price. | He offers it, and writes his offer from its About and what its files show, not from its name. |
| Teaser | The free file on a paid level. | He sends it first, so the fan wants the rest. |
| Paid pieces | The files behind the level's price. | He sells them locked. He never sells the whole level for less than its price. |

To build these parts step by step, see [Build your first collection](/ai-content/build-your-first-collection).

## Paid levels and free levels

A level is paid or free, and only its price decides which. A level with no price, or a price of 0, is free. The app calls a free level "a gift": everything on it goes out unlocked, and it is never sold.

The small word above each level's price tells you what the level does. The app shows this word in capitals.

| Word | What the level is |
| - | - |
| **floor** | A paid level. Its price is a floor: Hugo never sells the whole level for less. |
| **opener** | A free level that comes first in the collection. Hugo may send its files free before he offers a paid level. |
| **aftercare** | A free level after a paid level. It is optional. Like an opener, its files are free. |
| **free** | A free level in any other place, such as a second free level before any paid one. |

For details on each kind, see [Levels: teasers, paid pieces, openers and aftercare](/ai-content/levels).

## How Hugo sells from it

One sale usually goes like this:

1. A fan asks for something. Hugo looks for the levels that hold what the fan asks for. The level's tags, its name and its About help him match.
2. Hugo may send something free first: the level's teaser, or a file from a free level of the same collection. He never sends a fan a free file he has already had. He also never sells him a file he has already bought.
3. Hugo offers the paid files, locked. He sets the price from your floor and from what this fan has paid before.
4. When the fan unlocks the message, the sale is done. Hugo can offer him more later.

A few more rules decide what Hugo can offer:

* In a Story collection, Hugo offers the levels in order, one at a time. In a Menu collection, every level the fan has not bought is on offer at once. See [Story or Menu: choose how Hugo walks a collection](/ai-content/story-vs-menu).
* Hugo skips a paused collection and a paused level. Pausing keeps everything.
* A paid level with nothing behind its price is never offered. A paid level with no teaser still sells, but without a teaser to show first.
* Tags help Hugo match a level to what a fan asks for. A level without tags can still be sold. See [Set price floors and tags](/ai-content/prices-and-tags).

## Files come from the vault

The files on the board come from the creator's OnlyFans vault. For a Telegram creator, they come from her **Media** tab, and the board says "Media" instead of "Vault".

Sync the vault before you start. On the creator's page, click **Vault**. Then click **Sync vault**. The message "Vault sync queued" appears, and the files arrive in a minute or two.

A file can be on only one level. If you add a file to a second level, it moves there. This stops Hugo from selling one file at two prices.

## Read the numbers at the top

The top of the board shows three numbers and three buttons.

| On screen | What it tells you |
| - | - |
| "% of the vault placed" | How many vault files sit on a level, out of all the files in the vault |
| "levels sellable" | How many levels Hugo can sell, out of all levels. Levels in a paused collection do not count as sellable. |
| "collections live" | How many collections are not paused |

<Frame caption="**1** How much of the vault is placed · **2** Levels Hugo can sell · **3** Live collections">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/header-numbers-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=be0076491b0da3ef90d6786d01778618" alt="The top of the AI Content board with the share of the vault placed, the count of levels Hugo can sell and the count of live collections" width="1600" height="312" data-path="images/help/ai-content/how-ai-content-works/header-numbers-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/header-numbers-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=b327b907760d2a55ac146121df900e9f" alt="The top of the AI Content board with the share of the vault placed, the count of levels Hugo can sell and the count of live collections" width="1600" height="312" data-path="images/help/ai-content/how-ai-content-works/header-numbers-dark.png" />
</Frame>

The buttons:

* **How it works?** opens the app's own short guide to AI Content.
* **Focus** gives the board the whole screen on a computer. See [Work faster: shortcuts, focus mode, pause and undo](/ai-content/shortcuts-and-focus-mode).
* **Ask Hugo to set it up** shows a **Soon** badge. It is coming soon and cannot be used yet, so you build AI Content by hand.

<Frame caption="**How it works?** opens the app's own short guide">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/how-it-works-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=9ec55a228fc463073138756c673cc3a0" alt="The How AI Content works window, with the four steps of one sale: the ask, the free teaser, the paid piece and aftercare" width="1600" height="1615" data-path="images/help/ai-content/how-ai-content-works/how-it-works-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/how-it-works-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=5c4f81389595a5eb37b136d7da9b4ee2" alt="The How AI Content works window, with the four steps of one sale: the ask, the free teaser, the paid piece and aftercare" width="1600" height="1615" data-path="images/help/ai-content/how-ai-content-works/how-it-works-dark.png" />
</Frame>

## An empty board

A creator with no collections sees "Nothing for Hugo to sell yet". Hugo still answers her fans. To start, click **New collection** in the middle of the board.

<Frame caption="**1** New collection · **2** How it works?">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/empty-board-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=4cdc0c6d93365005f9f002f7645b7eba" alt="An empty AI Content board that says Nothing for Hugo to sell yet, with the New collection button in the middle" width="1600" height="723" data-path="images/help/ai-content/how-ai-content-works/empty-board-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/how-ai-content-works/empty-board-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=4b8d9ba094675689eef2211f0b5bbf1e" alt="An empty AI Content board that says Nothing for Hugo to sell yet, with the New collection button in the middle" width="1600" height="723" data-path="images/help/ai-content/how-ai-content-works/empty-board-dark.png" />
</Frame>

## Who can change it

Owners, admins and content VAs can build and change AI Content. A content VA works only on the creators assigned to them. Chatters can open the tab and read it, but a change they try shows "That did not save".

Owners and admins change roles and assigned creators in **Settings** > **Members**.

## Custom content is separate

Made-to-order content, such as a video shot for one fan, is not part of AI Content. Hugo does not price or sell it.

When a fan asks for a custom, Hugo keeps the conversation going, and may offer the nearest thing she already has. By default, the request is not escalated. On the newest Hugo, which answers almost every conversation, owners and admins may get a **Custom content request** alert, so your team can reply to the fan in the conversation. Not every request sends the alert: for example, an ask for something on her hard limits usually sends none.

If the row **Any custom while selling is off** in her **Escalation policy** is on, Hugo may escalate the request to your team. See [Custom Content: prices, menu and orders](/hugo/custom-content).

## What's next

<Columns cols={2}>
  <Card title="Build your first collection" icon="folder-plus" href="/ai-content/build-your-first-collection" horizontal />

  <Card title="Levels: teasers, paid pieces, openers and aftercare" icon="layers" href="/ai-content/levels" horizontal />

  <Card title="Story or Menu: choose how Hugo walks a collection" icon="list-ordered" href="/ai-content/story-vs-menu" horizontal />
</Columns>