Опишите новый наряд с помощью текста, чтобы наложить его на ИИ-модели.

Примерка по описанию

Конечная точка Примерки по описанию позволяет вам описать новый наряд с помощью текста, чтобы бесшовно наложить его на ИИ-модель.

Название модели: prompt-tryon

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

Время обработки: ~15s–40s (увеличивается при использовании ссылок на стили или модели)

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

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

Кредиты: 1 to 5 за генерацию (зависит от качества)

Запрос

Отправьте конфигурацию примерки на универсальную конечную точку /v1/run:

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

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

Аутентификация Вы можете передать свой ключ API либо как токен Bearer (Authorization: Bearer YOUR_API_KEY), либо через заголовок x-api-key (x-api-key: YOUR_API_KEY).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "Стильное красное летнее платье с цветочным узором.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Ответ

Генерация примерки происходит асинхронно в фоновом режиме. Ваш запрос немедленно вернет статус 200 OK с объектом отслеживания.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Опрос результатов Вы должны использовать возвращенный id для опроса конечной точки статуса (GET https://fititon.app/api/v1/status/{id}), чтобы получить URL-адреса сгенерированных изображений. Подробные инструкции см. в руководстве Настройка API.

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

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

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

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

personImageRequiredstring

Базовое изображение модели, которую вы хотите одеть. Может быть общедоступным URL-адресом или строкой изображения в кодировке Base64. Поддерживаемые форматы: JPEG, PNG, WEBP. Максимальный размер: 25 МБ.

Совет: Позы анфас с видимыми руками дают наиболее реалистичное наложение.

Требование к форматированию При отправке строки Base64 она должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,...). Конечная точка /v1/run принимает только JSON-полезные данные.

promptRequiredstring

Текстовое описание наряда, который вы хотите, чтобы модель носила.

Совет: Для достижения наилучших результатов укажите тип ткани (шелк, хлопок, деним) и стиль посадки (облегающий, оверсайз). Точно указывайте цвета ("темно-синий" работает лучше, чем "синий") и явно ссылайтесь на то, что модель уже носит, чтобы ИИ точно знал, что изменить.

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

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

Уровень выходного разрешения для Примерки по описанию (модели Gemini). Более высокие разрешения потребляют больше кредитов. По умолчанию: 1k

sampleCountinteger

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

ratiostring

Определяет соотношение ширины к высоте сгенерированного изображения. Если пусто, система по умолчанию использует соотношение сторон personImage.

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

modelImageUrlstring

Необязательно. URL-адрес эталонной модели человека, который будет использоваться вместо сохранения черт исходного человека.

Доступные предустановленные модели:

styleIdstring

Необязательно. Применить определенный фотографический стиль к выходному изображению.

Доступные стили:

Style Name	Style ID (`styleId`)

Допустимые значения: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

Примечание: Сложные стили могут увеличить общее время генерации.

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

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

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

Стоимость зависит от выбранного уровня quality и умножается на sampleCount.

Формула: Стоимость = КредитыЗаКачество × sampleCount

Параметр	Кредиты за изображение
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5