---
title: "Create a new model via external API"
method: POST
path: "/v1/external-models"
tags: ["External Models"]
---

# Create a new model via external API

`POST /v1/external-models`

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.

## Headers

- `x-api-key` string, required

## Request body

- CreateExternalModelRequestDtoClass
  - `name` string, required
  - `gender` 'male' | 'female', required
  - `description` string, required
  - `age` number, required
  - `ethnicity` string, required
  - `occupation` string, required
  - `hobbies` string, required
  - `hair` object, required
  - `body_type` string, required
  - `breast_size` string, required
  - `butt_size` string, required
  - `eyes_color` string, required
  - `personality_type` string, required
  - `relationship` string, required
  - `archetype` string, required
  - `category` string, required
  - `first_message` string, required
  - `initial_image_prompt` string, required
  - `system_prompt` string, required
  - `default_scenario_initial_message` string, required
  - `default_scenario_prompt` string, required
  - `first_message_media_type` 'image' | 'video', required
  - `personality` string[] — Optional. Array, empty array, null, or a single string.
  - `drive` string
  - `in_bed` string[] — Optional. Array, empty array, null, or a single string.
  - `secret` string
  - `kinks` string[] — Optional. Array, empty array, null, or a single string.
  - `availability_status` string
  - `relationship_context` string
  - `scenario_title` string
  - `scenario_hook` string

## Response `201`

Model created successfully with presigned upload URLs

## Other responses

- `422` — Validation failed

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)