Logo

Виртуальная примерка

Бесшовно примеряйте одежду на ИИ-моделей, используя изображения-референсы.

Виртуальная примерка (Примерка по изображению)

Конечная точка Try-On позволяет бесшовно примерять одежду на человека, используя изображение-референс.

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

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

Время обработки: ~15–30 с

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

Методы доставки: URL (через опрос)

Кредиты: 1 × sampleCount

Запрос

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

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": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Ответ

Генерация примерки происходит асинхронно в фоновом режиме. Ваш запрос немедленно вернет статус 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.

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

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

personImageRequiredstring

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

Совет профессионала: Позы анфас с видимыми руками обеспечивают наиболее реалистичное драпирование. Перед съемкой удалите сумки, шарфы или куртки, закрывающие тело.

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

garmentImageRequiredstring

Изображение предмета одежды для примерки. Может быть общедоступным URL-адресом или строкой изображения, закодированной в Base64.

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

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

accuracy'standard' | 'high' | 'hyper'

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

sampleCountinteger

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

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

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

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

Для запросов к API разработчика конечная точка виртуальной примерки работает по фиксированной ставке: 1 кредит за сгенерированное изображение, независимо от запрошенного уровня quality.

Формула: Стоимость = 1 × sampleCount

ПараметрКредитов за изображение
Фиксированная ставка1