Sign in
External Models

Create a new model via external API

Creates a new public model with all required fields and returns presigned upload URLs for avatar, face reference (WebP under static/face_reference), and first message media. The caller must upload files to the returned presigned URLs within 1 hour.

post/v1/external-models

Headers

x-api-keystring required

API key for authentication

Request body

namestring required
gender'male' | 'female' required
descriptionstring required
agenumber required
ethnicitystring required
occupationstring required
hobbiesstring required
hairobject required
body_typestring required
breast_sizestring required
butt_sizestring required
eyes_colorstring required
personality_typestring required
relationshipstring required
archetypestring required
categorystring required
first_messagestring required
initial_image_promptstring required
system_promptstring required
default_scenario_initial_messagestring required
default_scenario_promptstring required
first_message_media_type'image' | 'video' required
personalitystring[]

Optional. Array, empty array, null, or a single string.

drivestring
in_bedstring[]

Optional. Array, empty array, null, or a single string.

secretstring
kinksstring[]

Optional. Array, empty array, null, or a single string.

availability_statusstring
relationship_contextstring
scenario_titlestring
scenario_hookstring

Example request

{
  "name": "Chloe Brennan",
  "gender": "female",
  "description": "The girl with the pink hair and the five-year plan.",
  "age": 26,
  "ethnicity": "caucasian",
  "occupation": "Brand Strategist",
  "hobbies": "color-coded planners, 5am runs, late-night baking experiments",
  "hair": {
    "color": "pink",
    "technique": "solid",
    "silhouette": "long_loose"
  },
  "body_type": "average",
  "breast_size": "large",
  "butt_size": "medium",
  "eyes_color": "blue",
  "personality_type": "Innocent",
  "relationship": "Stranger",
  "archetype": "Girl Next Door",
  "category": "realistic_gfe",
  "first_message": "Oh my god. You were NOT supposed to see that.",
  "initial_image_prompt": "a pink-haired woman in a sundress at a convenience store",
  "system_prompt": "You are Chloe Brennan, a 26-year-old brand strategist...",
  "default_scenario_initial_message": "The 24-hour convenience store is dead except for you and a girl in the frozen aisle.",
  "default_scenario_prompt": "You are at a 24-hour convenience store late at night...",
  "first_message_media_type": "image",
  "personality": [
    "innocent",
    "ambitious"
  ],
  "drive": "fears_losing_control",
  "in_bed": [
    "passionate"
  ],
  "secret": "secretly_insatiable",
  "kinks": [
    "overstimulation",
    "public_risk"
  ],
  "availability_status": "single",
  "relationship_context": "stranger",
  "scenario_title": "Aisle Seven, One A.M.",
  "scenario_hook": "The 24-hour convenience store is dead..."
}

Response

Model created successfully with presigned upload URLs

Changes

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