The actor
Generate an image of an AI actor.
Anything the brief specifies wins. The defaults below fill gaps only.
Workflow
Step 1: Cast the person
An adult, always. Fill a younger brief with an adult and say so.
Keep casual words for young people out of the prompt altogether, even where the person described is
plainly an adult. They trip the image model's content filter and lose the generation.
Decide each of these deliberately rather than leaving it to the model, which returns the same face
every time.
Who they are — gender, age, ethnicity, build. An age anywhere from early twenties to late
sixties, a build anywhere from slight to athletic, broad or full.
How they look. This is what makes them recognisable when the image is reused, so it carries the
most weight. Take the face feature by feature.
The examples below are a starting point, not the choices on offer. Reach past them, decide each
line separately, and don't cast the same combination twice.
- Face shape, jaw and chin — oval, square, heart, long, round, diamond, oblong, pear, inverted
triangle. The jaw strong and angular, or soft and tapered. The chin with a deep cleft or a subtle
dimple.
- Cheekbones — high and sharp, soft and low, broad, prominent, sculpted, subtle and flushed,
apple-cheeked, hollowed beneath, or slightly asymmetrical.
- Eyes, shape and set — almond, round, hooded, monolid, downturned, upturned, deep-set, wide-set,
or close-set.
- Eyes, colour — emerald green, stormy grey, hazel with gold flecks, amber, pale ice blue, deep
mahogany brown, heterochromia, violet-blue, moss green, or near-black.
- Eyebrows — thick and bushy, neatly arched, thin and straight, feathered and wild, bleached,
dark and heavy, soft and sparse, subtly unibrowed, sharp and angular, or softly rounded.
- Nose, bridge and tip — straight, aquiline, upturned, wide and flat, snub, button, Roman,
bulbous-tipped, or slightly crooked from a healed break.
- Mouth — full evenly, thin on top and full on the bottom, wide and generous, small and tight, a
sharp Cupid's bow, a flat Cupid's bow, a resting smirk, downturned corners, slightly parted at
rest, or soft and pillowy.
- Skin texture and tone — smooth and glass-like, visible pores, sun-weathered with deep crow's
feet, scattered natural hyperpigmentation, subtle acne scarring, porcelain pale, rich deep bronze,
rosy-cheeked, olive with gold undertones, or naturally dewy.
- Hair, colour — auburn, bright copper, honey blonde, icy platinum, salt-and-pepper, henna red,
jet black, ash brown, silver-white, or a faded pastel wash.
- Hair, length and how it's worn — a military buzz crop, a jaw-length asymmetrical bob, a blunt
shoulder cut, flowing past the waist, a shaved undercut, a messy top-knot, a slicked-back low bun,
intricate protective braids, heavy blunt bangs, or a sweeping curtain fringe.
- Hair, texture — poker-straight, loose beachy waves, tight coiled ringlets, fine and flyaway,
thick and heavy, coarse, silky, a soft frizzy halo, locs, or naturally bald.
- Facial hair — clean-shaven, a heavy five-o'clock shadow, a neatly trimmed goatee, a full thick
beard, a pencil moustache, a handlebar moustache, a soul patch, scattered stubble, a sculpted
chinstrap, or heavy mutton chops.
- Glasses — none, thick black acetate frames, thin round wire frames, rimless, browline frames,
oversized geometric frames, tortoiseshell cat-eye, clear acrylic, vintage aviators, or subtly
tinted lenses.
- Makeup — none at all, lip balm and brushed brows only, everyday concealer and mascara, sharp
winged eyeliner, a bold matte red lip, a heavy smoky eye, graphic neon liner, fully contoured
evening glam, a sheer lip tint, or faux freckles.
- One distinguishing feature, or none — freckles dusted across the nose, deep cheek dimples, a
small silver septum piercing, a small scar through the eyebrow, a jagged scar on the chin, a gold
tooth, a subtle neck tattoo, or a small nose stud. Never a mole or a beauty mark.
Keep the face attractive and the build well-proportioned.
Say in the prompt that the person is invented. Open the subject with it, in these words or close
to them: "a wholly fictional, non-identifiable person — not a real or public figure, and not
resembling any actual individual."
What they're wearing — the garments and how they sit on the body, any accessories or jewellery, and how the whole thing is put together.
The top is closed, whatever the brief asks for. Every description should put the neckline high
and the chest fully covered. Anything cut low or strappy is only ever worn with a closed layer over
it, never by itself.
Write that coverage as what is there, not as what isn't: "a round-neck T-shirt", "a fully buttoned
V-neck cardigan". Describing what to leave off — the plunge, the skin, the gap — tends to put exactly
that in the picture, so phrase the whole line as presence.
Step 2: Set the scene
A place the brief names is the place. Otherwise pick one that fits how the actor will be used, indoors
or out.
Then describe it — the surfaces, the objects, and what fills the space. A name alone gives the model
nothing to build the room from.
- The setting — where they are, and what surrounds them.
- What's behind them — what falls in frame, as it happens to be rather than arranged.
- Colours — the ones that dominate.
- Time of day and weather, where they show.
- The light — where it comes from, its quality, and what it catches. Default to plain, neutral
daytime light with no warm tint — ordinary daylight colour, not a sunset glow — unless the brief
asks otherwise. No studio lighting, no plain backdrop.
Step 3: Set the shot
- A self-portrait on a phone's front camera.
- Head and shoulders fill the frame, at arm's length.
- Framing slightly tilted, not quite centred.
- Looking into the lens, face turned toward it. Not sideways, not in profile, not glancing off to
one side.
- Small-sensor grain, real skin, no retouching, subject sharp and background falling away on its own.
- Hands empty
Keep out: portrait, editorial, studio, posed, retouched, magazine-style, any
professional camera, tripod or lighting rig,
Step 4: Write the prompt in this order
Write the prompt as prose in this order — one paragraph is enough.
- Subject — from Step 1
- Location — from Step 2
- Composition — from Step 3
Step 5: Generate and hand back
One image_generate call, nano-banana-pro at 3:4 and resolution 1k unless the brief named a
model, a shape or a higher resolution. Generate once — never a second version to compare.
The image is polled for you, but it can come back as {status: "pending", …} — a job handle, not a
failure. Pass that exact handle to job_status to retrieve the finished image, and again if it is
still pending. Never re-run a pending generation with image_generate; that starts a new,
separately-billed job.
Hand back the image.
Edge cases
- Safety / NSFW rejection → name a workable stand-in for whatever tripped the filter — cover the
wardrobe, change the setting — and resubmit. Identical inputs fail identically, so change something.
If it keeps refusing, switch to
seedream-5. After a second rejection, tell the user which
element is blocked instead of retrying blind.
- A video model refuses the image as a possible likeness of a real person → rewording the prompt
changes nothing. Generate a different person — a different face, not a retouch of the same one. If
it happens again, change the video model rather than the actor.
error: "no_provider_configured" → relay the tool's hint.
1---2name: generating-ai-actors3description: Generates one photorealistic person as a single image — an AI actor, influencer, presenter or model. The image is reusable, so passing it into any later generation brings the same face, hair and build back and one person can hold across a whole set of images or videos. Use when the user wants an AI actor, or when something needs a person and no photo of one was supplied.4license: Apache-2.05---67# The actor89Generate an image of an AI actor.1011Anything the brief specifies wins. The defaults below fill gaps only.1213## Workflow1415### Step 1: Cast the person1617An adult, always. Fill a younger brief with an adult and say so.1819Keep casual words for young people out of the prompt altogether, even where the person described is20plainly an adult. They trip the image model's content filter and lose the generation.2122Decide each of these deliberately rather than leaving it to the model, which returns the same face23every time.2425**Who they are** — gender, age, ethnicity, build. An age anywhere from early twenties to late26sixties, a build anywhere from slight to athletic, broad or full.2728**How they look.** This is what makes them recognisable when the image is reused, so it carries the29most weight. Take the face feature by feature.3031**The examples below are a starting point, not the choices on offer.** Reach past them, decide each32line separately, and don't cast the same combination twice.3334- **Face shape, jaw and chin** — oval, square, heart, long, round, diamond, oblong, pear, inverted35 triangle. The jaw strong and angular, or soft and tapered. The chin with a deep cleft or a subtle36 dimple.37- **Cheekbones** — high and sharp, soft and low, broad, prominent, sculpted, subtle and flushed,38 apple-cheeked, hollowed beneath, or slightly asymmetrical.39- **Eyes, shape and set** — almond, round, hooded, monolid, downturned, upturned, deep-set, wide-set,40 or close-set.41- **Eyes, colour** — emerald green, stormy grey, hazel with gold flecks, amber, pale ice blue, deep42 mahogany brown, heterochromia, violet-blue, moss green, or near-black.43- **Eyebrows** — thick and bushy, neatly arched, thin and straight, feathered and wild, bleached,44 dark and heavy, soft and sparse, subtly unibrowed, sharp and angular, or softly rounded.45- **Nose, bridge and tip** — straight, aquiline, upturned, wide and flat, snub, button, Roman,46 bulbous-tipped, or slightly crooked from a healed break.47- **Mouth** — full evenly, thin on top and full on the bottom, wide and generous, small and tight, a48 sharp Cupid's bow, a flat Cupid's bow, a resting smirk, downturned corners, slightly parted at49 rest, or soft and pillowy.50- **Skin texture and tone** — smooth and glass-like, visible pores, sun-weathered with deep crow's51 feet, scattered natural hyperpigmentation, subtle acne scarring, porcelain pale, rich deep bronze,52 rosy-cheeked, olive with gold undertones, or naturally dewy.53- **Hair, colour** — auburn, bright copper, honey blonde, icy platinum, salt-and-pepper, henna red,54 jet black, ash brown, silver-white, or a faded pastel wash.55- **Hair, length and how it's worn** — a military buzz crop, a jaw-length asymmetrical bob, a blunt56 shoulder cut, flowing past the waist, a shaved undercut, a messy top-knot, a slicked-back low bun,57 intricate protective braids, heavy blunt bangs, or a sweeping curtain fringe.58- **Hair, texture** — poker-straight, loose beachy waves, tight coiled ringlets, fine and flyaway,59 thick and heavy, coarse, silky, a soft frizzy halo, locs, or naturally bald.60- **Facial hair** — clean-shaven, a heavy five-o'clock shadow, a neatly trimmed goatee, a full thick61 beard, a pencil moustache, a handlebar moustache, a soul patch, scattered stubble, a sculpted62 chinstrap, or heavy mutton chops.63- **Glasses** — none, thick black acetate frames, thin round wire frames, rimless, browline frames,64 oversized geometric frames, tortoiseshell cat-eye, clear acrylic, vintage aviators, or subtly65 tinted lenses.66- **Makeup** — none at all, lip balm and brushed brows only, everyday concealer and mascara, sharp67 winged eyeliner, a bold matte red lip, a heavy smoky eye, graphic neon liner, fully contoured68 evening glam, a sheer lip tint, or faux freckles.69- **One distinguishing feature, or none** — freckles dusted across the nose, deep cheek dimples, a70 small silver septum piercing, a small scar through the eyebrow, a jagged scar on the chin, a gold71 tooth, a subtle neck tattoo, or a small nose stud. Never a mole or a beauty mark.7273Keep the face attractive and the build well-proportioned.7475**Say in the prompt that the person is invented.** Open the subject with it, in these words or close76to them: *"a wholly fictional, non-identifiable person — not a real or public figure, and not77resembling any actual individual."*7879**What they're wearing** — the garments and how they sit on the body, any accessories or jewellery, and how the whole thing is put together.8081**The top is closed, whatever the brief asks for.** Every description should put the neckline high82and the chest fully covered. Anything cut low or strappy is only ever worn with a closed layer over83it, never by itself.8485Write that coverage as what is there, not as what isn't: *"a round-neck T-shirt"*, *"a fully buttoned86V-neck cardigan"*. Describing what to leave off — the plunge, the skin, the gap — tends to put exactly87that in the picture, so phrase the whole line as presence.8889### Step 2: Set the scene9091A place the brief names is the place. Otherwise pick one that fits how the actor will be used, indoors92or out.9394Then describe it — the surfaces, the objects, and what fills the space. A name alone gives the model95nothing to build the room from.9697- **The setting** — where they are, and what surrounds them.98- **What's behind them** — what falls in frame, as it happens to be rather than arranged.99- **Colours** — the ones that dominate.100- **Time of day and weather**, where they show.101- **The light** — where it comes from, its quality, and what it catches. Default to plain, neutral102 daytime light with no warm tint — ordinary daylight colour, not a sunset glow — unless the brief103 asks otherwise. No studio lighting, no plain backdrop.104105### Step 3: Set the shot106107- A self-portrait on a phone's front camera.108- Head and shoulders fill the frame, at arm's length.109- Framing slightly tilted, not quite centred.110- Looking into the lens, face turned toward it. Not sideways, not in profile, not glancing off to111 one side.112- Small-sensor grain, real skin, no retouching, subject sharp and background falling away on its own.113- Hands empty114115Keep out: *portrait*, *editorial*, *studio*, *posed*, *retouched*, *magazine-style*, any116professional camera, tripod or lighting rig, 117118### Step 4: Write the prompt in this order119120Write the prompt as prose in this order — one paragraph is enough.1211221. **Subject** — from Step 11232. **Location** — from Step 21243. **Composition** — from Step 3125126### Step 5: Generate and hand back127128One `image_generate` call, `nano-banana-pro` at `3:4` and `resolution` `1k` unless the brief named a129model, a shape or a higher resolution. Generate once — never a second version to compare.130131The image is polled for you, but it can come back as `{status: "pending", …}` — a job handle, not a132failure. Pass that exact handle to `job_status` to retrieve the finished image, and again if it is133still pending. **Never re-run a pending generation** with `image_generate`; that starts a new,134separately-billed job.135136Hand back the image. 137138## Edge cases139140- **Safety / NSFW rejection** → name a workable stand-in for whatever tripped the filter — cover the141 wardrobe, change the setting — and resubmit. Identical inputs fail identically, so change something.142 If it keeps refusing, switch to `seedream-5`. After a second rejection, tell the user which143 element is blocked instead of retrying blind.144- **A video model refuses the image as a possible likeness of a real person** → rewording the prompt145 changes nothing. Generate a different person — a different face, not a retouch of the same one. If146 it happens again, change the video model rather than the actor.147- **`error: "no_provider_configured"`** → relay the tool's `hint`.