Skip to main content
AI content is the catalogue the AI chatter sells from, for one creator. You take media from her OnlyFans vault, group it into priced levels, and put the levels in ladders that the AI climbs with each fan. Nothing here is posted anywhere: it only tells the AI what exists, what it costs at minimum, and in what order to offer it. Read it with GET /v1/creators/{creatorId}/ai-content (ai:read); build it with the calls in Build the AI content ladder (ai:write).

The building blocks

Levels and prices

Every level has a priceCents:
  • priceCents greater than 0 is a floor: the AI may sell the level for more, never for less. 1200 means at least $12.00. The price also stays inside OnlyFans’ own limits for paid messages on that account; a floor below OnlyFans’ minimum is raised to it.
  • priceCents: 0 makes a free level (free: true). Everything on it is sent free, as preview, and the AI uses it as a gift rather than a sale.
A priced level needs at least one paid media item before the AI can sell it. A free level needs at least one item of any kind.

Preview versus paid media

Each media item on a level has a role: On a free level every item is a preview. Adding media to a free level always stores it as preview.

Free opener and free aftercare

Two free levels are common in a sequential ladder:
  • A free opener as level 1: a small free gift that starts the ladder and makes the first paid offer feel natural.
  • A free aftercare level as the last level: a warm thank-you after the fan bought the top level, which closes the ladder kindly instead of pushing for more.
A level with priceCents: 0 gives its media away. Always set priceCents deliberately, and check free in the response. A paid set created at 0 by mistake is sent free to every fan who reaches it.

Ladder modes: sequential or standard

Reorder levels with PUT .../collections/{collectionId}/order. In a sequential ladder that changes the climb for every fan.

How the AI decides what to offer

When a conversation reaches a moment to sell, the AI:
  1. Considers only active ladders and active levels that are available in paid messages (availableInPaidMessages: true).
  2. Skips what this fan already bought.
  3. In a sequential ladder, looks only at the next unbought level; in a standard ladder, at all of them.
  4. Picks what fits the conversation, using the level’s tags (matched against what the fan talks about), its description, its highlight (a one-line hook it can lead with), and the ladder’s description.
  5. Sends the preview media free and the paid media locked, at or above the floor price, in the creator’s voice.
Good tags and descriptions make better matches:

Level stats

Each level reports stats for sales the AI made: These count the AI’s own offers only; sales your team made by hand are not included.

Vault coverage

The board also reports vault: {total, assigned, unassigned}: how many items the creator’s vault holds, how many are placed on a level, and how many are not. A large unassigned count is content the AI cannot sell yet.

The board in one response

GET /v1/creators/{creatorId}/ai-content returns the whole board, and every write returns the updated board, so you never have to stitch pieces together.
ContentBoard (shortened)

Rules the API enforces

  • Media ids are the vault ids from GET /v1/creators/{creatorId}/media (strings of digits). Items from an OnlyX media library appear as ox: ids.
  • One item lives on one level. Adding an item to a level moves it from wherever it was.
  • A folderId must belong to the same creator, or you get 404.
  • Deleting a folder keeps its ladders (they become unfiled). Deleting a ladder deletes its levels and their media placements. Deleting a level renumbers the ones after it.
  • Nothing in AI content is published to OnlyFans. Only the AI’s offers in chats reach fans.
  • Creates answer 201, every other write 200, always with the whole board. Content writes are limited to 60 per minute per credential.