> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Influencers and Characters
> Cast BudgetPixel's free AI influencers, or your own characters, in any image or video prompt with an @mention, from your code or AI agent. Same face in every post. List them, download every picture, and get influencer picks for a brief.
A character is a face and a look you can cast again and again: write its `@handle` in a
prompt and its picture and look go with it, so the same person appears in every image and
video. BudgetPixel has **23 official AI influencers**, free for every user: Barry, who is rich
in his head, Neville and his neck, Rosa, who meditates until the bench breaks, Fifi and her
ten-centimetre lashes, and more. Your own characters, and the ones you collected from the
[marketplace](https://budgetpixel.com/characters/explore), work the same way.
> **[AI influencers on BudgetPixel](https://budgetpixel.com/characters)**
>
> Meet all 23, watch them in action, and cast one in the studio.
```bash theme={null}
curl https://api.budgetpixel.com/v1/images/seedream-5.0-pro \
-H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "@barry orders a coffee like he owns the cafe, candid photo"}'
```
```json theme={null}
{
"id": "img_a1b2c3d4e5f6",
"status": "pending",
"model": "seedream-5.0-pro",
"characters": [
{ "handle": "barry", "name": "Barry", "official": true, "page_url": "https://budgetpixel.com/characters/…" }
]
}
```
> [!NOTE]
>
> Available on **every paid plan**, like the rest of the API. Over [MCP](/mcp-server), your
> agent does the same with `list_characters`, `get_character` and `recommend_influencers`, and
> casts with an @mention in `generate_image` or `generate_video`.
## Meet the influencers
Each one comes with a look nobody forgets, a story, a catchphrase and a dozen reference
pictures. Open one to see them all, or write the handle in a prompt.
Barry
@barry · Rich in His Head
[“Obviously.”](https://budgetpixel.com/characters/bfaa78ab-a3c0-4537-b979-b5c851cd6853)
Neville
@neville · The Neck
[“I saw that.”](https://budgetpixel.com/characters/c86020f2-6b4e-4f46-83d0-1e0b471cc9c3)
Rocco
@rocco · The Gentle Giant
[“Nope.”](https://budgetpixel.com/characters/7e50ff8e-7bca-401a-98cd-785f5d0a49e8)
Nana Gloria
@nanagloria · Skill Issue
[“Skill issue.”](https://budgetpixel.com/characters/9cfdc1b2-3fe6-4372-80cc-91f111daf797)
Rosa
@rosa · Ruckus
[“Breathe... or else.”](https://budgetpixel.com/characters/8b09033e-510a-43c8-95c5-e38caf0f53e6)
Theo
@theo · Big Eyes
[“Game changer.”](https://budgetpixel.com/characters/dfe473b1-cd33-40bc-bd62-646e4261985b)
Ophelia
@ophelia · The Fringe
[“Trust me.”](https://budgetpixel.com/characters/a6cb463f-326f-4f72-bd74-a3816934f7d8)
Chad Pemberton III
@chad · The Closer
[“Let's circle back.”](https://budgetpixel.com/characters/45a0c96e-0bba-4e71-95c5-0f7a9ebe6eeb)
Mabel
@mabel · Halo
[“Made with love!”](https://budgetpixel.com/characters/b3923204-5d69-4fb9-802b-c1726d8dd255)
Juno
@juno · Wild Life
[“Fascinating.”](https://budgetpixel.com/characters/c2644d8b-2db8-4f38-9a0b-834a5002b670)
Dex
@dex · Unstoppable
[“Unstoppable!”](https://budgetpixel.com/characters/a4583444-3429-4351-920e-a3b716e1ed65)
Sir Reginald
@sirreginald · His Royal Pugness
[“Indeed.”](https://budgetpixel.com/characters/6c57fe92-1b43-4267-8183-62fdf68620c1)
Coach Coo
@coachcoo · The Pigeon Coach
[“Hustle!”](https://budgetpixel.com/characters/1ef770eb-d9a0-4125-8151-3f6cdd8e9dfb)
Marco
@marco · The Explorer
[“Next stop: everywhere.”](https://budgetpixel.com/characters/8f7c9c19-d3bd-4c08-a2e3-d1695d4d2f13)
Tex
@tex · The Big Hat
[“Yeehaw, your order's here.”](https://budgetpixel.com/characters/cd361d44-8eba-451b-ae10-069b6385f822)
Fifi
@fifi · One More Coat
[“Wait, one more coat.”](https://budgetpixel.com/characters/8e4e8681-f8b9-42cb-8009-d10d7f96a688)
Barnaby
@barnaby · The One-Man Band
[“Any requests?”](https://budgetpixel.com/characters/6cabe910-4d5f-43bc-8f2c-daadabfcd4d1)
Sunny
@sunny · Goth Sunshine
[“Everything is wonderful!”](https://budgetpixel.com/characters/43fe8cf4-6548-4f0d-9ab0-4f06d1dff6eb)
Hank
@hank · Twinkle Toes
[“And... plié.”](https://budgetpixel.com/characters/82586131-0c1e-4101-b6e9-1444e528d05a)
Pâté
@pate · The Critic
[“Non.”](https://budgetpixel.com/characters/44792a6f-5ed9-48c1-a20d-27d054eea0e3)
Yuzu
@yuzu · Zen Master
[“Just vibe.”](https://budgetpixel.com/characters/d6357ff2-9629-464b-9a73-91292cd2cbd4)
Jai
@jai · Iron Ankles
[“Again!”](https://budgetpixel.com/characters/3646ffca-c381-46ee-a6a0-e39479fa8fc2)
Kev
@kev · Party Animal
[“It's a party!”](https://budgetpixel.com/characters/d9d253d6-e238-4111-9c3a-526747c28c02)
## Casting with an @mention
* Write `@handle` anywhere in the `prompt` of an image or video generation. The mention is
replaced by the character's name and look, and its default picture is added as the first
reference image.
* `@handle.tag` casts a specific picture instead of the default one, for example
`@barry.full_body` or `@fifi.selfie`. A character's tags are in `picture_tags`.
* Up to **4 characters** per generation, each one a mention.
* Only handles you can cast resolve: the influencers, your own characters and the ones you
collected. Any other `@word`, and an e-mail address, stays plain text.
* The model must take characters. `supported_models` on
[`GET /v1/characters/{handle}`](/api-reference/characters/get-a-character) lists them, and
the `prompt` of each such model says so in the API reference. A mention on any other model
is refused with the list of models that can take it.
* Character pictures are reference images: on video models they use reference-to-video mode,
so don't combine a mention with a start or end frame.
The create response lists the cast in `characters`, with each character's page. When you
post the result, crediting the influencer helps people find them.
### In action
Each clip is one video prompt with an influencer @mentioned, made with Seedance 2.5 on
BudgetPixel. Turn the sound on: they talk.
@rosa meditates. The bench does not survive.
@chad holds a single sheet of paper like a billion-dollar contract
@nanagloria wins in a neon gaming room
@barry says he is the leader. @neville saw that.
## List the characters you can cast
```bash theme={null}
curl "https://api.budgetpixel.com/v1/characters?source=official&q=fitness" \
-H "Authorization: Bearer $BUDGETPIXEL_API_KEY"
```
[`GET /v1/characters`](/api-reference/characters/list-characters-you-can-cast) returns the
influencers first (this week's trending ones on top), then your own characters, then the
collected ones. Each comes with its `mention`, title, catchphrase, a one-line `summary`,
traits, picture tags and a preview. Filter with `source` (`official`, `mine`, `collected`)
and `q` (words that must all appear in the name, look or profile).
## Everything about one character
[`GET /v1/characters/{handle}`](/api-reference/characters/get-a-character) returns:
* `look`: the character's look, word for word. It is the text a mention sends with the
picture, so you can reuse it with other tools.
* The profile: `personality`, `speaking_style`, `backstory`, `in_their_head` and `reality`,
`directing_notes`, `signature_details` and `consistency_rules`. Use it to write prompts,
captions and scripts in the character's voice.
* `pictures`: every picture (portrait, full body, side profile, expressions, selfie, action,
scene and more) with a download link. For the influencers and your own characters these are
the **full-size files** (the influencers' portraits are 4K), so you can use the character
with other image and video tools too. A collected character's pictures are preview size.
Links are signed and expire after a few hours.
* `supported_models`, `how_to_use`, and for the influencers `usage`: the terms for using them.
### Using an influencer elsewhere
The influencers are free to cast in the images and videos you make, on BudgetPixel or with
other tools. When you post, please credit them as "Barry, a BudgetPixel AI influencer" with a
link to their page (`page_url`).
> [!WARNING]
>
> BudgetPixel's influencers are never shown nude or in sexual content. On BudgetPixel such a
> request is refused with `restriction_reason: "official_character_nudity"`; suggestive outfits
> and poses are fine. The same rule is part of the terms for using them anywhere else.
## Influencer recommendations
```bash theme={null}
curl https://api.budgetpixel.com/v1/characters/recommend \
-H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brief": "A 10-second TikTok ad for a protein shake aimed at gym beginners", "count": 3}'
```
[`POST /v1/characters/recommend`](/api-reference/characters/recommend-influencers-for-a-brief)
casts for you: describe what you are making, for whom and where it will be posted, and get the
influencers who fit it best, each with `why`, a content `idea` and a ready-to-use `prompt`
that starts with their mention. Set `include_mine` to consider your own and collected
characters too.
## Pricing and limits
* The three character endpoints are **free**, with daily limits per account (the API and MCP
together): 300 list calls, 100 character calls and 30 recommendations. Past a limit the
endpoint answers `429` with `Retry-After`, until 00:00 UTC.
* Casting adds no fee: a generation costs what the model costs. A character's picture counts
as a reference image, which a few models price per image, and
[`POST /v1/cost`](/api-reference/models/estimate-the-cost-of-a-request) counts the
characters in your prompt the same way.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.