Sign in
Digital Twins

Create Digital Twin

Creates a new digital twin character. Processing happens asynchronously. Poll the status endpoint to track completion.

post/api/v1/digital-twins

Request body

namestring required

Character display name

aliasstring required

Character nickname / short name

dateOfBirthstring date required

Date of birth (ISO format). Character must be 21+

jobstring required

Character occupation

locationstring required

Where the character lives

genderGender required— unresolved $ref
orientationOrientation required— unresolved $ref
hairColourstring required

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

eyeColourstring required

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

bodyTypestring required

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

referenceImageUrlstring uri required

URL to reference image (downloaded and saved to S3)

contentLevelContentLevel — unresolved $ref
profileImageUrlstring uri

URL to profile image (converted to PNG and saved)

biostring

Character biography

textingStylestring

Texting/communication style

ethnicitystring

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

hairLengthstring

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

breastSizestring

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

tattoosstring

Tattoo description

physicalCharacteristicsstring[]

Physical characteristics (array of strings)

personalitystring[]

Personality traits. Values must match valid terms — use GET /api/v1/characters/personalities for the full list

interestsstring[]

Character interests. Values must match valid terms — use GET /api/v1/characters/interests for the full list

kinksstring[]

Character kinks. Values must match valid terms — use GET /api/v1/characters/kinks for the full list

audioSpeednumber float

Audio playback speed multiplier

socialHandleInstagramstring

Instagram handle

vaginaHairstring

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

relationshipStatusstring

Relationship status

backstorystring

Character backstory. Auto-generated if not provided

coverVideoUrlstring uri

URL to cover video (downloaded and saved to S3)

voiceUrlstring uri

HTTP URL to voice reference audio file (.wav). For best results, ~30 seconds of clear speech

socialHandleTiktokstring

TikTok handle

socialHandleTwitterstring

X/Twitter handle

socialHandleYoutubestring

YouTube handle

socialHandleTwitchstring

Twitch handle

socialHandleTelegramstring

Telegram handle

earlyAccessEmailinteger

Early access email entity reference

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)

platinumListPricenumber float

Platinum list price (field_list_price_b)

Response

Digital twin creation started. Poll status endpoint for completion.

successboolean
digitalTwinIdstring uuid

Digital twin UUID for status polling

status'pending' | 'active' | 'draft' | 'inactive'

Digital twin processing status:

  • pending: Creation/update in progress
  • active: Digital twin is ready and live
  • draft: Initial state before processing
  • inactive: Deactivated
messagestring

Example response

{
  "success": true,
  "message": "Digital twin creation started. Poll GET /api/v1/digital-twins/status/{digitalTwinId} for progress."
}

Changes