Characters
Generate AI Character
Generates a new AI character in Postgres, creates S3 pre-signed URLs, and triggers ComfyUI reference image generation. Required fields: nationality, ethnicity, firstName, lastName, biography.
post/api/v1/characters/generate
Request body
b2bClientIdstring
B2B client ID (required if ohFunCreatorId not provided)
ohFunCreatorIdstring
OhFun creator ID (required if b2bClientId not provided)
nationality'American' | 'Brazilian' | 'Russian' | 'Colombian' | 'Ukrainian' | 'Japanese' | 'Filipino' | 'Thai' | 'Mexican' | 'Canadian' | 'British' | 'Korean (South)' | 'Vietnamese' | 'Indian' | 'Chinese' | 'German' | 'French' | 'Italian' | 'Spanish' | 'Australian' | 'Swedish' | 'Polish' | 'Dutch' | 'Venezuelan' | 'Dominican' | 'Argentine' | 'Peruvian' | 'Czech' | 'Romanian' | 'Hungarian' | 'Turkish' | 'Lebanese' | 'Israeli' | 'Greek' | 'Serbian' | 'Croatian' | 'Bulgarian' | 'Belgian' | 'Norwegian' | 'Danish' | 'Finnish' | 'Irish' | 'Scottish' | 'Portuguese' | 'New Zealander' | 'South African' | 'Jamaican' | 'Puerto Rican' | 'Cuban' | 'Costa Rican' | 'Panamanian' | 'Salvadoran' | 'Nigerian' | 'Ghanaian' | 'Kenyan' | 'Moroccan' | 'Algerian' | 'Egyptian' | 'Tunisian' | 'Pakistani' | 'Bangladeshi' | 'Indonesian' | 'Malaysian' | 'Singaporean' | 'Taiwanese' | 'Hong Konger' | 'Emirati (UAE)' | 'Saudi' | 'Qatari' | 'Kuwaiti' | 'Jordanian' | 'Syrian' | 'Iranian' | 'Afghan' | 'Kazakh' | 'Georgian' | 'Armenian' | 'Lithuanian' | 'Latvian' | 'Estonian' | 'Belarusian' | 'Moldovan' | 'Slovak' | 'Slovenian' | 'Austrian' | 'Swiss' | 'Icelandic' | 'Maltese' | 'Cypriot' | 'Albanian' | 'Bosnian' | 'Macedonian' | 'Montenegrin' | 'Chilean' | 'Ecuadorian' | 'Paraguayan' | 'Uruguayan' | 'Bolivian' | 'Honduran' | 'Nicaraguan' required
Character nationality
ethnicity'Caucasian / White' | 'Latina / Hispanic' | 'Black / African-American' | 'Asian (East Asian)' | 'Mixed / Biracial' | 'Brazilian' | 'Russian / Slavic' | 'Colombian' | 'Ukrainian' | 'Japanese' | 'Filipina' | 'Thai' | 'Korean' | 'Mexican' | 'Ebony / West African' | 'Chinese' | 'Indian (South Asian)' | 'Vietnamese' | 'Middle Eastern / Arab' | 'Mediterranean (Greek/Italian/Spanish)' | 'Scandinavian / Nordic' | 'Venezuelan' | 'Dominican' | 'Argentine' | 'Peruvian' | 'Eastern European' | 'Puerto Rican' | 'Cuban' | 'Asian-Caucasian Mix' | 'Black-Caucasian Mix' | 'Latina-Caucasian Mix' | 'Pawg (White with big assets)' | 'BBC-adjacent Black' | 'Light-skin Black' | 'Caramel / Latina' | 'Olive / Mediterranean' | 'Pale / Porcelain White' | 'Tanned / Beach Latina' | 'Redhead / Ginger' | 'Blonde Scandinavian' | 'Brunette European' | 'Jewish (Ashkenazi)' | 'Persian / Iranian' | 'Turkish' | 'Lebanese' | 'Armenian' | 'Native American' | 'Pacific Islander' | 'Polynesian / Samoan' | 'Moroccan / North African' | 'Egyptian' | 'Algerian' | 'Nigerian' | 'Ghanaian' | 'Kenyan' | 'South African (White)' | 'South African (Coloured)' | 'Jamaican' | 'Trinidadian' | 'Barbadian' | 'Punjabi / North Indian' | 'Tamil / South Indian' | 'Bengali' | 'Pakistani' | 'Indonesian' | 'Malaysian' | 'Singaporean Chinese' | 'Taiwanese' | 'Hong Kong Chinese' | 'Eurasian (Asian + White)' | 'Blasian (Black + Asian)' | 'Afro-Latina' | 'Arab' | 'Kurdish' | 'Greek' | 'Italian' | 'Spanish' | 'Portuguese' | 'French' | 'German' | 'Dutch' | 'Polish' | 'Czech' | 'Romanian' | 'Hungarian' | 'Serbian' | 'Croatian' | 'Bulgarian' | 'Albanian' | 'Bosnian' | 'Gypsy / Romani' | 'Maori' | 'Aboriginal Australian' | 'Hmong' | 'Cambodian' | 'Lao' | 'Mongolian' | 'Kazakh' | 'Uyghur' | 'Afghan / Pashtun' required
Character ethnicity
dateOfBirthstring
Date of birth. Character must be 21+. If not provided, defaults to 27 years old.
firstNamestring required
Character first name
lastNamestring required
Character last name
biographystring required
Character biography/backstory
aliasstring
Character alias/nickname
jobstring
Specific job title
whereYouLivestring
Location where character lives
genderstring
Character gender
orientation'Straight' | 'Bisexual' | 'Mostly straight' | 'Bi-curious' | 'Pansexual' | 'Lesbian' | 'Heteroflexible' | 'Bicurious (leans men)' | 'Bicurious (leans women)' | 'Demisexual' | 'Queer' | 'Mostly lesbian' | 'Homoflexible' | 'Asexual (but enjoys sex with partner)' | 'Fluid' | 'Gay (Men)' | 'Experimenting' | 'Open to anything' | 'Straight but plays with girls' | '90/10 (mostly straight)'
Character's sexual orientation. Affects who the character is attracted to in text conversations.
sexualExperience'Virgin' | 'Almost virgin' | 'Very limited' | 'Moderate' | 'Experienced' | 'Very experienced' | 'Highly experienced' | '100+ partners' | 'Former escort' | 'Nymphomaniac' | 'Only relationships' | 'Mostly one-night stands' | 'Lots of threesomes' | 'Swinger' | 'Porn-level' | 'Innocent but curious' | 'Sheltered then wild' | 'Reformed good girl' | 'Always slutty' | 'Recently awakened'
Character's sexual experience level. Affects the character's personality and how they discuss sexual topics in text conversations.
kinksstring[]
Character's sexual preferences and kinks. Used to shape the character's personality and behavior in text conversations only — they do not control image or video generation capabilities.
sexPositionsstring[]
Character's preferred sex positions. These define the character's personality and preferences for text conversations only — they do not control image or video generation capabilities.
relationshipStyle'Monogamous girlfriend' | 'Devoted housewife' | 'Free-use 24/7' | 'Stay-at-home girlfriend' | 'Open relationship' | 'Trophy girlfriend' | 'Submissive girlfriend' | 'Dominant girlfriend' | 'Casual FWB' | 'Sugar baby' | 'Collared & owned' | 'Hotwife' | 'Cuckquean' | 'Polyamorous' | 'Secret affair' | 'Traditional 1950s' | 'Brat to be tamed' | 'Fiancée' | 'Live-in slut' | 'Long-distance girlfriend'
Character's relationship dynamic with the user. Affects how the character behaves and relates to the user in text conversations.
relationshipStatus'Single' | 'In a relationship' | 'Engaged' | 'Married' | 'Divorced' | 'Widowed' | 'It's complicated' | 'Open relationship' | 'Situationship' | 'Single and looking' | 'Single not looking' | 'Taken but bored' | 'Friends with benefits' | 'Dating around' | 'Exclusively yours'
Character's relationship status. Part of the character's backstory, affects text conversation context.
interestsstring[]
Character interests
personality'Sweet & innocent' | 'Bratty' | 'Bubbly / genki' | 'Shy & submissive' | 'Flirty tease' | 'Tsundere' | 'Yandere' | 'Confident boss babe' | 'Nerdy / gamer girl' | 'Spoiled princess' | 'Girl-next-door' | 'Ice queen (melts for you)' | 'Himbo-level ditzy' | 'Dominant & teasing' | 'Obsessed / clingy' | 'Low-maintenance chill' | 'High-maintenance diva' | 'Gothic / alt girl' | 'Bookworm / quiet intellectual' | 'Hyper horny nympho' | 'Reformed good girl' | 'Total bimbo' | 'Caring mommy vibe' | 'Sassy & sarcastic' | 'Daddy's little princess'
Character's personality archetype. Shapes the character's overall behavior and tone in text conversations.
sexDrive'Very high' | 'Hypersexual nympho' | 'High' | 'Always horny' | 'Average' | 'Touch-starved' | 'Insatiable' | 'High but shy' | 'Moderate' | 'Low until aroused then wild' | 'Once a day minimum' | 'Morning sex addict' | 'Only horny when ovulating' | 'Switches normal to crazy' | 'Low' | 'Very low cuddly' | 'Asexual but enjoys pleasing' | 'Permanently in heat' | 'Night owl horny' | 'Needs it to fall asleep'
Character's sex drive level. Affects the character's eagerness and initiative in text conversations.
conversationStyle'Flirty & teasing' | 'Sweet & innocent' | 'Bratty & sassy' | 'Shy & soft-spoken' | 'Bubbly & giggly' | 'Dirty talk queen' | 'Proper & polite' | 'Valley girl' | 'Weeb / anime speech' | 'Tsundere' | 'Baby-talk / little space' | 'Foul-mouthed & trashy' | 'Sarcastic & witty' | 'Submissive & obedient' | 'Dominant & commanding' | 'Country / southern drawl' | 'Nerdy & rambling' | 'High-maintenance princess' | 'Low-key & chill' | 'Constant compliments & praise'
Character's conversation style. Controls the tone and manner of the character's text responses.
attitude'Sweet & innocent' | 'Bratty' | 'Bubbly & cheerful' | 'Shy & submissive' | 'Flirty tease' | 'Tsundere' | 'Yandere' | 'Spoiled princess' | 'Confident boss babe' | 'Nerdy gamer girl' | 'Ice queen' | 'Sassy & sarcastic' | 'Clingy & obsessed' | 'Dominant & commanding' | 'Girl-next-door' | 'Gothic / alt' | 'Ditzy bimbo' | 'Caring mommy' | 'High-maintenance diva' | 'Low-key chill'
Character's attitude. Influences the character's demeanor in text conversations.
heightstring
Character height
bodyBuild'Slim' | 'Petite' | 'Athletic' | 'Toned' | 'Curvy' | 'Hourglass' | 'Slender' | 'Fit' | 'Thick' | 'BBW' | 'Skinny' | 'Muscular' | 'Chubby' | 'Voluptuous' | 'Lean' | 'Model-thin' | 'Pear shape' | 'Busty athletic' | 'Soft & curvy' | 'Amazon / tall & strong' | 'Buxom' | 'Average' | 'Busty' | 'Slim, athletic,' | 'Busty hourglass' | 'Athletic-Curvy,' | 'Petite hourglass' | 'Tall, Athletic Hourglass' | 'Muscular-athletic' | 'Athletic-Curvy'
Body build type
bodyShape'Hourglass' | 'Pear' | 'Apple' | 'Rectangle' | 'Inverted triangle' | 'Slim hourglass' | 'Thick hourglass' | 'Bottom-heavy pear' | 'Top-heavy' | 'Balanced curvy' | 'Athletic rectangle' | 'Soft pear' | 'Petite hourglass' | 'Busty rectangle' | 'Bubble butt pear' | 'Slim-thick' | 'Coke-bottle' | 'Shelf booty' | 'Voluptuous hourglass' | 'Chubby apple'
Body shape
buttSize'Big' | 'Round & full' | 'Bubble butt' | 'Thick' | 'Jiggly' | 'Huge' | 'Average' | 'Small' | 'Shelf-like' | 'Peach' | 'Juicy' | 'Massive' | 'Firm & round' | 'Flat' | 'Phat' | 'Heart-shaped' | 'Perky' | 'Wide'
Butt size
hairLength'Long (mid-back to waist)' | 'Very long (waist to hips)' | 'Shoulder-length' | 'Extra long (classic length – below butt)' | 'Medium / lob (long bob, just past shoulders)' | 'Short bob' | 'Chin-length bob' | 'Pixie cut' | 'Butt-length' | 'Chest / bra-strap length' | 'Hip-length' | 'Short layered' | 'Tailbone length' | 'Shaved sides + long top' | 'Bald / completely shaved' | 'Buzzcut' | 'Asymmetrical bob' | 'Undercut' | 'Mid-back' | 'Knee-length (extreme rare)' | 'Floor-length (extreme fantasy)' | 'Short crop' | 'Pageboy' | 'Shag / wolf cut' | 'Mullet (modern sexy version)'
Hair length
hairColour'Black' | 'Dark Brown' | 'Blonde' | 'Light Brown' | 'Platinum Blonde' | 'Jet Black' | 'Golden Blonde' | 'Honey Blonde' | 'Strawberry Blonde' | 'Auburn' | 'Chestnut Brown' | 'Ash Blonde' | 'Caramel Brown' | 'Chocolate Brown' | 'Dirty Blonde' | 'Natural Red / Ginger' | 'Raven Black' | 'Sandy Blonde' | 'Rose Gold' | 'Silver / Grey' | 'Pastel Pink' | 'Ombré (dark to blonde)' | 'Balayage Blonde' | 'Copper Red' | 'Violet / Purple' | 'Blue' | 'White Blonde' | 'Burgundy' | 'Ice Blonde' | 'Butter Blonde' | 'Bronde' | 'Champagne Blonde' | 'Smokey Lilac' | 'Fiery Red' | 'Mahogany' | 'Green' | 'Dark Auburn' | 'Ash Brown' | 'Peach' | 'Lavender'
Hair colour
eyeColour'Blue' | 'Hazel' | 'Green' | 'Brown / Dark Brown' | 'Grey' | 'Light Blue' | 'Ice Blue / Pale Blue' | 'Amber / Golden' | 'Heterochromia (two different colors)' | 'Dark Brown (almost black)' | 'Emerald Green' | 'Honey Brown' | 'Grey-Blue' | 'Violet / Purple (real or contacts)' | 'Aqua / Turquoise' | 'Grey-Green' | 'Central Heterochromia (e.g., brown with green ring)' | 'Deep Green' | 'Sky Blue' | 'Steel Grey' | 'Golden Brown' | 'Red / Albino' | 'Cat-like Yellow/Gold' | 'Sectoral Heterochromia (pie slice)' | 'Bright Green'
Eye colour
skinTone'Light / Fair' | 'Tan / Golden' | 'Olive / Mediterranean' | 'Caramel / Light Brown' | 'Medium Brown' | 'Deep Tan / Bronzed' | 'Porcelain / Very Pale' | 'Deep Brown / Chocolate' | 'Ebony / Very Dark' | 'Honey' | 'Beige' | 'Warm Ivory' | 'Golden Olive' | 'Light Caramel' | 'Mocha' | 'Rich Brown' | 'Sun-Kissed' | 'Alabaster' | 'Latte' | 'Mahogany' | 'Warm Honey' | 'Light Olive' | 'Tawny' | 'Espresso' | 'Pale Ivory'
Skin tone
breastSize'C cup' | 'D cup' | 'DD / E cup' | 'B cup' | 'Natural C' | 'Perky D' | 'Big natural (DD–F)' | 'Small / A–B' | 'Large / F–G' | 'Fake / Obviously augmented' | 'Full C' | 'Perfect handful (firm B–C)' | 'Huge / H+' | 'Petite / Flat-to-A' | 'Bolt-ons (fake D–DD)' | 'Teardrop implants' | 'Very perky C' | 'Full DD' | 'Small & perky' | 'Massive naturals (G–H)' | 'Athletic small (A–B)' | 'Round fake DD' | 'Tiny / AA–A' | 'Oversized implants (H–K)' | 'Soft & full D'
Breast size
breastPertness'Perky' | 'Firm & perky' | 'Natural perky' | 'Full & perky' | 'Slightly pendulous (natural hang)' | 'Very perky / youthful' | 'Teardrop shape' | 'Round & firm' | 'Soft & natural' | 'Augmented / fake perky' | 'Perfect teardrop' | 'High & firm' | 'Full but soft' | 'Athletic / toned & perky' | 'Gently sloping' | 'Heavy & full (natural sag)' | 'Bolt-on / obviously fake round' | 'Puffy nipples + perky' | 'East-West (point outward)' | 'Slightly sagging (post-baby natural)' | 'Perfectly round implants' | 'Torpedo / tubular' | 'Wide-set & perky' | 'Small & super perky' | 'Mature / naturally pendulous'
Breast pertness
nippleColour'Light pink' | 'Pink' | 'Rose / Medium pink' | 'Dark pink' | 'Light brown' | 'Medium brown' | 'Dark brown' | 'Pale pink (almost white)' | 'Rosy brown' | 'Deep brown / Chocolate' | 'Almost black' | 'Peachy pink' | 'Mauve' | 'Tan brown' | 'Reddish-pink' | 'Dusky rose' | 'Caramel brown' | 'Puffy light pink' | 'Puffy dark pink' | 'Inverted (dark pink/brown)'
Nipple colour
vaginaHair'Completely shaved / bald' | 'Landing strip' | 'Smooth wax (Brazilian – everything off)' | 'Neat triangle' | 'Small trimmed patch' | 'Hollywood (100 % bare)' | 'Thin landing strip' | 'Full bush (natural 70s style)' | 'Trimmed short / low maintenance' | 'Heart shape' | 'Brazilian with tiny strip' | 'Natural but shaped' | 'Dyed to match hair' | 'Arrow / V shape' | 'Partially shaved sides' | 'Lightning bolt' | 'Au naturel / untouched bush' | 'Short & curly (Afro-textured)' | 'Thin vertical strip' | 'Completely natural long' | 'Diamond shape' | 'French wax (strip + lips bare)' | 'Designer (letters/symbols)' | 'Colored bush (pink/blue/etc.)' | 'Wild & untrimmed'
Vagina hair style
vaginaSize'Tight' | 'Very tight' | 'Super tight' | 'Snug' | 'Average' | 'Petite tight' | 'Extremely tight' | 'Youthfully tight' | 'Slightly looser' | 'Perfectly snug' | 'Tight but accommodating' | 'Incredibly tight' | 'Normal' | 'Loose & wet' | 'Very accommodating' | 'Post-baby looser' | 'Gripping' | 'Relaxed' | 'Well-used' | 'Milf-level relaxed'
Vagina size
additionalDescriptionstring
Free-text traits added to the reference image that the structured fields can't express. Examples: nose piercing, hooped earrings, cherry blossom sleeve tattoo, wire-frame glasses, thin scar above the left eyebrow.
Example request
{
"dateOfBirth": "1995-06-15",
"height": "5'7\"",
"additionalDescription": "six months pregnant, small dragon tattoo across the right hip, wire-frame glasses, a thin scar above the left eyebrow"
}Response
AI character generated successfully
successboolean
Whether the generation was successful
characterIdstring
Unique identifier for the generated character
messagestring
Status message