Sign in
Admin Models

Create a new model

Create a new model with the provided data

post/admin/models

Request body

namestring required

The name of the model

descriptionstring

The description of the model

photostring

The photo URL of the model

videostring

The video URL of the model

avatarIconstring

Avatar icon key under static prefix (e.g., avatarIcon.webp)

tiktokVideostring

TikTok video key under static/tiktok

onboardingImagestring

Onboarding image key under static/onboarding

useVideoboolean

Whether the model uses video

isPublicboolean

Whether the model is public

isExplicitboolean

Whether the model contains explicit content

gender'male' | 'female'

The gender of the model

breastSize'small' | 'medium' | 'large' | 'xl'

The breast size of the model

bodyType'slim' | 'average' | 'athletic' | 'chubby'

The body type of the model

buttSize'small' | 'medium' | 'large'

The butt size of the model

ethnicity'caucasian' | 'latina' | 'asian' | 'arab' | 'afro' | 'indian' | 'furry' | 'kemonomimi' | 'tiefling'

The ethnicity of the model

agenumber required

The age of the model (any number between 18 and 99)

eyesColor'Blue' | 'Brown' | 'Green'

The eye color of the model

hairStyle'Straight' | 'Braids' | 'Bangs' | 'Bun' | 'Curly' | 'Short' | 'Long' | 'Pigtails' | 'Ponytail' | 'Emo' | 'Shoulder-length' | 'Buzz' | 'Pixie' | 'Hijab' | 'Veil'

The hair style of the model

hairColor'Blonde' | 'Brunette' | 'Black' | 'Red' | 'Pink' | 'Blue' | 'Violet' | 'Airtouch' | 'Black with blonde highlights' | 'Ombre'

The hair color of the model

personality'Caregiver' | 'Sage' | 'Innocent' | 'Jester' | 'Temptress' | 'Dominant' | 'Submissive' | 'Lover' | 'Nympho' | 'Mean' | 'Confidant' | 'Experimenter'

The personality of the model

occupation'Massage Therapist' | 'Dentist' | 'Nutritionist' | 'Fitness Coach' | 'Artist' | 'Pharmacist' | 'Hairdresser' | 'Makeup Artist' | 'Gynecologist' | 'Writer' | 'Secretary' | 'Librarian' | 'Social Worker' | 'Fashion Designer' | 'Model' | 'Police Officer' | 'Nurse' | 'Yoga Instructor' | 'Waitress' | 'Cook' | 'Unemployed' | 'Dancer' | 'Teacher' | 'Student' | 'Life Coach' | 'Astronaut' | 'Kindergarten Teacher' | 'Soldier/Military Personnel' | 'Architect' | 'DJ' | 'Nun'

The occupation of the model

hobbiesstring[]

The hobbies of the model

relationship'Stranger' | 'School Mate' | 'Colleague' | 'Mentor' | 'Girlfriend' | 'Sex Friend' | 'Wife' | 'Mistress' | 'Friend' | 'Best Friend' | 'Step Sister' | 'Step Mom'

The relationship type of the model

voicestring

The voice type of the model

firstMsgstring

The first message from the model

firstMsgImagestring

The first message image URL

firstMsgImageSfwstring

Open first-message photo, shown to everyone

firstMsgImageNsfwstring

Explicit first-message photo, blurred until subscribed

firstMsgImageNsfwBlurredstring

Pre-blurred copy of the explicit photo, generated on upload

firstMsgVideostring

The first message video URL

firstMsgVideoPreviewstring

The first message video preview URL

firstMsgVideoDurationnumber

The duration of the first message video in seconds

userFirstMsgHelpstring

Help text for the user's first message

userIdstring

The user ID who owns this model (for private models)

ordernumber

The display order of the model

isProboolean

Whether this is a premium model

baseViewsnumber

Synthetic baseline for the social-rating views shown on the card

baseLikesnumber

Synthetic baseline for the social-rating likes shown on the card

ohwxPersonalityPlaceholderstring

OHWX personality LoRA placeholder (e.g., lora:NAME:W)

ohwxAppearancePlaceholderstring

OHWX appearance LoRA placeholder (e.g., lora:NAME:W1 or lora:NAME:W1:W2)

ohwxFemaleReplacestring

Replacement text for occurrences of "ohwx female" in prompts

systemPromptTextstring

Initial system prompt text (optional; if provided and generation is off, it will be saved as-is)

generateSystemPromptboolean

Whether to generate system prompt and description automatically after creation

initialImagePromptstring

Initial image generation prompt (for direct chat)

defaultScenarioCoverstring

S3 key for the default scenario cover image (direct chat)

defaultScenarioInitialMessagestring

Initial message shown after the cover image (direct chat)

defaultScenarioPromptstring

Prompt stored in the cover image attachment (direct chat)

allowedChatModesstring[]

Chat modes this model may be started in (GEN-1386). At least one; ROLEPLAY runs the scripted opening + Visual Director, REALISTIC opens with the plain firstMsg and no Director.

isDemoboolean

Whether this model is a demo character

initialPhotoSFWstring

S3 key for the SFW intro photo (demo models)

initialPhotoNSFWstring

S3 key for the NSFW blurred intro photo (demo models)

demoIntroVideostring

S3 key for demo intro video (static / demo_intro)

demoModelPreviewVideostring

S3 key for ethnicity source demo preview clip (static / demo_model_preview)

onboardingSubscriptionRewardVideoPreviewstring

S3 key for subscription reward still (FLUX Klein edit) under static / onboarding_sub_reward_preview

onboardingSubscriptionRewardVideostring

S3 key for subscription reward short video (i2v from edit) under static / onboarding_sub_reward_video

Example request

{
  "name": "Sarah",
  "description": "A friendly and caring personality",
  "photo": "https://example.com/photo.jpg",
  "video": "https://example.com/video.mp4",
  "avatarIcon": "avatarIcon.webp",
  "tiktokVideo": "tiktok/model_tiktok.mp4",
  "onboardingImage": "onboarding/model_onboarding.webp",
  "isPublic": true,
  "gender": "female",
  "breastSize": "medium",
  "bodyType": "slim",
  "buttSize": "small",
  "ethnicity": "asian",
  "age": 25,
  "eyesColor": "Brown",
  "hairStyle": "Long",
  "hairColor": "Black",
  "personality": "Caregiver",
  "occupation": "Nurse",
  "hobbies": [
    "Yoga",
    "Fitness"
  ],
  "relationship": "Friend",
  "voice": "Soft and gentle",
  "firstMsg": "Hi! I'm so glad to meet you!",
  "firstMsgImage": "https://example.com/first-msg.jpg",
  "firstMsgImageSfw": "https://example.com/first-msg-sfw.webp",
  "firstMsgImageNsfw": "https://example.com/first-msg-nsfw.webp",
  "firstMsgVideo": "https://example.com/first-msg.mp4",
  "firstMsgVideoPreview": "https://example.com/first-msg-preview.jpg",
  "firstMsgVideoDuration": 30,
  "userFirstMsgHelp": "Try saying hello or asking about my day!",
  "userId": "user-uuid-here",
  "order": 1,
  "baseViews": 280,
  "baseLikes": 120,
  "generateSystemPrompt": true
}

Response

Model created successfully

modelModel required

Changes

No recorded changes to this endpoint across all 1 revision of this API.