# Create Project

Create a new project within the organization. 

Project Locking & Training Version:
Projects can be dedicated to a specific training version family (FIBO or Legacy).
* If training_version is provided: The project is locked to that family immediately.
* If training_version is omitted (null): The project remains unlocked until the first dataset is created. Upon creating the first dataset, the project automatically inherits the dataset's training_version and becomes locked to that family.

Families:
* FIBO: fibo
* Legacy: max, light, 3.2, 2.3 (Legacy versions are interchangeable within a project).

The following IP types are supported:

Defined Character
A specific character that maintains consistent identity and unique traits while being reproduced in different poses, situations, and actions.

Medium: Photography



Medium: Illustration



Stylized Scene
Complete environments or scenes created with a consistent visual style, look, and feel.

Medium: Photography



Medium: Illustration



Multi-Object Set
A collection of different objects sharing a common style, design language, or color scheme. Objects are typically isolated on solid backgrounds.


Object Variants
Multiple variations of the same object type, maintaining consistent style and structure while showing different interpretations. Objects are typically isolated on solid backgrounds.


Icons
A collection of cohesive, small-scale illustrations or symbols designed to represent concepts, actions, or objects in interfaces and applications. Maintains consistent visual style across the set.


Character Variants
Multiple characters sharing the same fundamental structure, style, and color palette, allowing creation of new characters that fit within the established design system.

Endpoint: POST /tailored-gen/projects

## Header parameters:

  - `api_token` (string, required)

## Request fields (application/json):

  - `project_name` (string)
    Name of the project (required)

  - `project_description` (string)
    Description of the project (optional)

  - `ip_name` (string)
    Required only for defined_character IP type. The name of the character (1-3 words, e.g., "Lora", "Captain Smith"). This name will be incorporated into the automatically created caption prefix and generation prefix, used consistently during training and generation.

  - `ip_description` (string)
    Required only for defined_character and object_variants IP types. A short phrase (up to 6 words) describing only the most crucial distinguishing features of your character (e.g., "a female character with purple hair"). Keep it brief as the model will learn additional details from the training images. This description will be incorporated into the automatically created caption prefix and generation prefix, used during training and generation.

  - `ip_medium` (string)
    Medium of the IP (required)
* photography
* illustration
    Enum: "photography", "illustration"

  - `ip_type` (string)
    Type of the IP (required):
* defined_character: A specific predefined character or person that can be reproduced consistently in different situations, poses, or actions, preserving their identity and unique traits.
* stylized_scene: A complete scene or environment, such as a gaming background or a series of photos with a shared color palette, created with a cohesive style, look, and feel.
* other: For IP types that don't fit into any of the types 

The Types below are currently avilable only when ip_medium = illustration:
* object_variants: Variations of the same object type, designed with consistent style, structure, and coloring, showcasing different interpretations. These objects are often isolated on a solid background. 
* multi_object_set: Multiple distinct objects that share a mutual style, design language, or color scheme. These objects are often isolated on a solid background. 
* icons: A collection of small, visually distinct illustrations, such as symbols or graphical elements, designed with a cohesive style and used to represent concepts, actions, or objects in interfaces, applications, or visual communication materials. 
* character_variants: Multiple characters sharing the same structure, style, and color palette, with the ability to create new characters that adhere to these shared characteristics while introducing unique elements.
    Enum: "multi_object_set", "object_variants", "icons", "defined_character", "character_variants", "stylized_scene", "other"

## Response 201 fields (application/json):

  - `id` (integer)
    Unique identifier for the project

  - `project_name` (string)
    Name of the project

  - `project_description` (string)
    Description of the project

  - `ip_name` (string)
    Name of the IP

  - `ip_description` (string)
    Description of the IP

  - `ip_medium` (string)
    Medium of the IP

  - `ip_type` (string)
    Type of the IP

  - `training_version` (string,null)
    The training version family this project is locked to (e.g., 'fibo', 'max', or null if unlocked).

  - `status` (string)
    Status of the project
    Enum: "active"

  - `created_at` (string)
    Timestamp when the project was created


## Response 400 fields

## Response 401 fields

## Response 429 fields

## Response 500 fields