Sign in
Characters V2

Generate AI Character

Creates a new AI character with async profile generation. Returns immediately with 'generating' status. Poll the status endpoint until status is 'ready'.

post/api/v2/characters/generate

Request body

nationalitystring required

Character nationality. Use GET /api/v1/characters/nationalities for valid values

ethnicitystring required

Character ethnicity. Use GET /api/v1/characters/ethnicities for valid values

firstNamestring required

Character first name

lastNamestring required

Character last name

biographystring required

Character biography/bio text. Auto-generated if missing

dateOfBirthstring date

Date of birth (ISO format). Must be 21+. Defaults to age 27 if not provided

aliasstring

Character alias/nickname

jobstring

Character occupation

whereYouLivestring

Location where character lives

gender'Female' | 'Male' required

Character gender

penisSize'Small' | 'Huge' | 'Enormous'

Penis size (male only)

vaginaHair'Bald' | 'Designer' | 'Diamond shape' | 'French wax' | 'Full bush' | 'Heart shape' | 'Landing strip' | 'Lightning bolt' | 'Long' | 'Natural' | 'Neat triangle' | 'Partially shaved sides' | 'Shaved' | 'Small trimmed patch' | 'Smooth wax' | 'Thin landing strip' | 'Thin vertical strip' | 'Tiny Brazilian' | 'Trimmed' | 'Trimmed short' | 'V shaped' | 'Wild'

Pubic hair style (female only). Use GET /api/v1/characters/vagina-hair for valid values

vaginaSize'Accommodating' | 'Average' | 'Extremely tight' | 'Gilf' | 'Gripping' | 'Incredibly tight' | 'Loose & wet' | 'Milf' | 'Normal' | 'Perfectly snug' | 'Petite tight' | 'Post-baby looser' | 'Relaxed' | 'Slightly looser' | 'Snug' | 'Super tight' | 'Tight' | 'Very Accommodating' | 'Very tight' | 'Well-used' | 'Youthfully tight'

Vagina size (female only). Use GET /api/v1/characters/vagina-sizes for valid values

physicalCharacteristicsstring[]

Array of additional physical features not covered by other fields (e.g., glasses, freckles, pregnancy, piercings)

orientation'90/10' | 'Asexual' | 'Bi-curious' | 'Bicurious' | 'Bisexual' | 'Demisexual' | 'Experimenting' | 'Fluid' | 'Gay' | 'Heteroflexible' | 'Homoflexible' | 'Lesbian' | 'Mostly straight' | 'Open to anything' | 'Pansexual' | 'Queer' | 'Sapiosexual' | 'Straight' | 'Straight but plays with girls'

Character's sexual orientation. Affects who the character is attracted to in text conversations.

personalitystring[]

Character's personality archetype. Shapes the character's overall behavior and tone in text conversations.

interestsstring[]

Character interests. Values must match valid terms — use GET /api/v1/characters/interests for the full list. Auto-generated if missing

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.

hairLengthstring

Hair length. Use GET /api/v1/characters/hair-lengths for valid values

hairColourstring

Hair colour. Use GET /api/v1/characters/hair-colours for valid values

eyeColourstring

Eye colour. Use GET /api/v1/characters/eye-colours for valid values

breastSizestring

Breast size (female only). Use GET /api/v1/characters/breast-sizes for valid values. Auto-generated if missing

bodyBuildstring

Body build type. Use GET /api/v1/characters/body-builds for valid values

backstorystring

Character backstory. Auto-generated if missing

textingStylestring

texting/communication style description. Auto-generated if missing

tattoosstring

tattoo description. Auto-generated if missing

profileImageUrlstring uri

URL to profile image (downloaded and saved automatically)

coverVideoUrlstring uri

URL to cover video (downloaded and saved automatically)

voiceUrlstring uri

HTTP URL to voice audio file (downloaded automatically)

audioSpeednumber float

Audio playback speed multiplier

socialHandleInstagramstring

Instagram handle

socialHandleTiktokstring

TikTok handle

socialHandleTwitterstring

X/Twitter handle

heightstring

Character height

bodyShape'Apple' | 'Athletic' | 'Balanced' | 'Bottom-heavy pear' | 'Busty rectangle' | 'Chubby' | 'Hourglass' | 'Inverted triangle' | 'Pear' | 'Petite hourglass' | 'Rectangle' | 'Slim hourglass' | 'Soft pear' | 'Thick hourglass' | 'Top-heavy' | 'Voluptuous hourglass'

Body shape. Use GET /api/v1/characters/body-shapes for valid values

buttSize'Average' | 'Big' | 'Bubble Butt' | 'Firm & round' | 'Flat' | 'Heart-shaped' | 'Huge' | 'Jiggly' | 'Juicy' | 'Massive' | 'Peach' | 'Perky' | 'Phat' | 'Round & Full' | 'Shelf' | 'Small' | 'Thick' | 'Wide'

Butt size. Use GET /api/v1/characters/butt-sizes for valid values

skinTone'Alabaster' | 'Beige' | 'Caramel' | 'Deep Brown' | 'Deep Tan' | 'Ebony' | 'Espresso' | 'Golden' | 'Golden Olive' | 'Honey' | 'Latte' | 'Light' | 'Light Caramel' | 'Light Olive' | 'Mahogany' | 'Medium Brown' | 'Mocha' | 'Olive' | 'Pale Ivory' | 'Rich Brown' | 'Sun-Kissed' | 'Tan' | 'Tawny' | 'Very Pale' | 'Warm Honey' | 'Warm Ivory'

Skin tone. Use GET /api/v1/characters/skin-tones for valid values

breastPertnessstring

Breast pertness (female only). Use GET /api/v1/characters/breast-pertness for valid values

nippleColour'Almost black' | 'Caramel brown' | 'Dark brown' | 'Dark pink' | 'Deep brown' | 'Dusky rose' | 'Light brown' | 'Light pink' | 'Mauve' | 'Medium brown' | 'Medium pink' | 'Peachy pink' | 'Pink' | 'Puffy dark pink' | 'Puffy light pink' | 'Reddish-pink' | 'Rosy brown' | 'Tan brown'

Nipple colour (female only). Use GET /api/v1/characters/nipple-colours for valid values

relationshipStatusstring

Relationship status

imageModelstring

Image model for generation

contentLevel'Sexy' | 'Topless' | 'Nudes' | 'Sex'

Maximum content level the character will engage with. Determines what the character is willing to do in both text conversations and media generation. Sexy = suggestive/clothed, Topless = partial nudity, Nudes = full nudity, Sex = explicit sexual content.

bodyTypestring

Body type (valid value from lookup endpoint)

eyeColorstring

Eye color (valid value from lookup endpoint)

hairColorstring

Hair color (valid value from lookup endpoint)

socialHandleYoutubestring

YouTube handle

socialHandleTwitchstring

Twitch handle

socialHandleTelegramstring

Telegram handle

earlyAccessEmailinteger

Early access email entity reference

weightinteger

Character weight/ordering

priorityPricenumber float

Priority subscription price (field_sub_a)

platinumPricenumber float

Platinum subscription price (field_sub_b)

vipPricenumber float

VIP subscription price (field_sub_c)

priorityListPricenumber float

Priority list price (field_list_price_a)

sexDrive'Always horny' | 'Asexual but enjoys pleasing' | 'Average' | 'High' | 'High but shy' | 'Hypersexual nympho' | 'Insatiable' | 'Low' | 'Low until aroused then wild' | 'Moderate' | 'Morning sex addict' | 'Needs it to fall asleep' | 'Night owl horny' | 'Once a day minimum' | 'Only horny when ovulating' | 'Permanently in heat' | 'Switches normal to crazy' | 'Touch-starved' | 'Very high' | 'Very low cuddly'

Character's sex drive level. Affects the character's eagerness and initiative in text conversations.

conversationStyle'Baby-talk / little space' | 'Bratty & sassy' | 'Bubbly & giggly' | 'Constant compliments & praise' | 'Country / southern drawl' | 'Dirty talk queen' | 'Dominant & commanding' | 'Flirty & teasing' | 'Foul-mouthed & trashy' | 'High-maintenance princess' | 'Low-key & chill' | 'Nerdy & rambling' | 'Proper & polite' | 'Sarcastic & witty' | 'Shy & soft-spoken' | 'Submissive & obedient' | 'Sweet & innocent' | 'Tsundere' | 'Valley girl' | 'Weeb / anime speech'

Character's conversation style. Controls the tone and manner of the character's text responses.

sexualExperience'100+ partners' | 'Almost virgin' | 'Always slutty' | 'Experienced' | 'Former escort' | 'Highly experienced' | 'Innocent but curious' | 'Lots of threesomes' | 'Moderate' | 'Mostly one-night stands' | 'Nymphomaniac' | 'Only relationships' | 'Porn-level' | 'Recently awakened' | 'Reformed good girl' | 'Sheltered then wild' | 'Swinger' | 'Very experienced' | 'Very limited' | 'Virgin'

Character's sexual experience level. Affects the character's personality and how they discuss sexual topics in text conversations.

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

{
  "nationality": "American",
  "ethnicity": "Caucasian",
  "firstName": "Aria",
  "lastName": "Storm",
  "biography": "A free-spirited artist with a passion for adventure",
  "dateOfBirth": "1995-06-15",
  "physicalCharacteristics": [
    "wears glasses",
    "has freckles",
    "beauty mark on cheek"
  ],
  "personality": [
    "Adventurous",
    "Playful",
    "Confident"
  ],
  "interests": [
    "Photography",
    "Travel",
    "Cooking"
  ],
  "hairLength": "Long",
  "hairColour": "Blonde",
  "eyeColour": "Blue",
  "breastSize": "Medium",
  "bodyBuild": "Athletic",
  "textingStyle": "Playful and flirty with lots of emojis",
  "tattoos": "Small butterfly on right shoulder",
  "height": "5'7\"",
  "breastPertness": "Perky",
  "contentLevel": "Sex",
  "additionalDescription": "six months pregnant, small dragon tattoo across the right hip, wire-frame glasses, a thin scar above the left eyebrow"
}

Response

Character generation started. Poll status endpoint for completion.

successboolean
characterGuidstring uuid

Character GUID for status polling and save operation

status'draft' | 'generating' | 'ready' | 'saving' | 'saved' | 'failed'

V2 character processing status:

  • draft: Initial state
  • generating: AI generation in progress
  • ready: Generation complete, ready to save
  • saving: Save in progress
  • saved: Fully saved and ready to use
  • failed: Processing failed (check errorMessage)
characterobject

Initial character data

messagestring

Example response

{
  "success": true,
  "message": "Character generation started. Poll GET /api/v2/characters/{characterGuid}/status for progress."
}

Changes