Генерируйте совершенно уникальные AI-модели одежды или загружайте собственные эталонные изображения для использования в примерках.

Создание модели

Создание модели позволяет генерировать реалистичные модели одежды с помощью простых, интуитивно понятных запросов или эталонных изображений, а также загружать существующие изображения моделей в ваше рабочее пространство.

Название модели: model-create

Жизненный цикл: stable

Время обработки: ~10–30 с (увеличивается при использовании расширенных ссылок, таких как лицо/поза)

Формат вывода: Auto (JPEG или PNG)

Методы доставки: URL

Кредиты: от 1 до 5 за модель (1k: 1, 2k: 3, 4k: 5)

Запрос

Генерируйте или загружайте модели одежды, отправляя свою конфигурацию на универсальную конечную точку /v1/run:

POSThttps://fititon.app/api/v1/run

Примеры запросов

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Ответ

Поскольку генерация модели может занимать до 30 секунд, конечная точка /v1/run немедленно возвращает статус 201 Created с асинхронным идентификатором задания id. Вы должны опрашивать API статуса, используя GET /v1/status/{id}, чтобы получить окончательные результаты. В качестве альтернативы вы можете настроить веб-хуки для автоматического получения уведомлений. Обратите внимание, что наш диспетчер веб-хуков устанавливает строгое 15-секундное ограничение по времени. Ваш сервер должен подтвердить веб-хук кодом состояния 2xx в течение 15 секунд, иначе мы посчитаем его неудачным и повторим попытку позже.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Как только status изменится на "succeeded", поле output будет содержать массив с URL-адресом, указывающим на вашу сгенерированную модель:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/model-123.png"
  ]
}

Параметры запроса

Обязательные параметры

typeRequired'generate' | 'upload'

Указывает, следует ли генерировать новую модель с помощью ИИ (generate) или загружать существующее изображение (upload).

nameRequiredstring

Описательное имя для вашей модели. Используется для идентификации модели в вашей студии.

promptstring

Обязательно для генерации Текстовое описание генерируемой модели. Описывает желаемую модель одежды, одежду, позу и фоновую сцену.

Совет профессионала: Если вы используете ссылку, такую как faceModelId, ИИ будет отдавать приоритет идентичности ссылки, но будет использовать ваш запрос для определения обстановки, наряда и характеристик тела. Необязательно только при наличии faceModelId.

imageBase64string

Обязательно для загрузки Строка изображения, закодированная в Base64. Обязательно, когда type установлено на upload.

Требование к форматированию Ваша строка Base64 должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,... или data:image/png;base64,...). Загрузка завершится неудачей, если будет предоставлена только необработанная закодированная строка.

Необязательные параметры генерации

Эти параметры применяются, когда type установлено на generate.

genderstring

Пол модели. Помогает модели генерации определять физические атрибуты.

bodyTypestring

Тип телосложения модели (например, "спортивное", "плюс сайз", "стройное").

clothingstring

Конкретные детали одежды, которые необходимо учесть при генерации, дополняя основной prompt.

posestring

Текстовое описание позы (например, "стоит, руки в карманах", "идет").

faceModelIdstring

UUID существующей модели лица для фиксации определенной идентичности в разных поколениях. Вывод будет адаптироваться к целевому запросу, сохраняя при этом эталонное лицо.

Примечание: Предоставление ссылки на лицо добавляет несколько секунд к общему времени обработки, поскольку ИИ выравнивает идентичность.

poseModelIdstring

UUID существующей модели позы. Принуждает генерацию строго соответствовать эталону позы и осанки тела.

Примечание: Предоставление ссылки на позу увеличивает время обработки.

poseImageBase64string

Строка изображения, закодированная в Base64, для использования в качестве специальной ссылки на позу вместо предоставления сохраненного poseModelId.

quality'1k' | '2k' | '4k'

Уровень выходного разрешения. 1k производит вывод ~1 мегапиксель, 2k ~4 мегапикселя, а 4k ~16 мегапикселей. Более высокие разрешения потребляют больше кредитов. По умолчанию: 1k

aspectRatiostring

Определяет соотношение ширины и высоты сгенерированного изображения.

Поддерживаемые значения: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

По умолчанию: 3:4

sampleCountinteger

Количество вариантов изображений для генерации на один запрос. Дополнительные изображения потребляют больше кредитов и линейно увеличивают время обработки. По умолчанию: 1

Ошибки выполнения

Ошибки выполнения для этой функции используют общий набор, задокументированный в Обработка ошибок. Если во время обработки возникает ошибка, status обновится до "error", а поле error будет содержать конкретную причину сбоя.

Стоимость кредитов

Для запросов Developer API стоимость зависит от выбранного уровня quality вывода.

Уровень качества	Кредитов за модель
1k (По умолчанию)	1
2k	3
4k	5