Превратите фотографии товаров, снятых в раскладке или на манекене-невидимке, в профессиональные снимки на модели.

Продукт на модель

Конечная точка «Продукт на модель» преобразует фотографии товаров, снятых в раскладке или на манекене-невидимке, в профессиональные снимки на модели, позволяя вам указать внешний вид модели или фотографический стиль.

Имя модели: product-to-model

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

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

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

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

Кредиты: 1 to 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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Ответ

Поскольку генерация изображения может занимать до 20 секунд, конечная точка /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/product-model-123.png"
  ]
}

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

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

productImageRequiredstring

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

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

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

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

customPromptstring

Текстовые инструкции, описывающие желаемую модель (например, пол, этническая принадлежность, поза) или сцену. Максимальная длина: 500 символов.

modelImageUrlstring

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

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

Примечание: Предоставление эталонной модели увеличивает общее время обработки.

styleIdstring

Идентификатор фотографического стиля для применения (например, "studio", "iphone", "editorial"). Если опущено, по умолчанию используется нейтральная студийная презентация.

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

Style Name	Style ID (`styleId`)

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

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

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

sampleCountinteger

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

ratiostring

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

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

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

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

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

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

Формула: Cost = QualityCredits × sampleCount

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