Руководство · Виртуальная примерка

Что такое API виртуальной примерки? и что он возвращает

В двух словах

API виртуальной примерки принимает фото одежды и возвращает изображение этой одежды на модели. Вы отправляете POST-запрос с фотографией, манекеном и позой, опрашиваете статус задачи, а затем скачиваете результат.

Получить API-ключДокументация
  • Типичное время: 1.5–4 min
  • Кредиты: 5 credits при 2K · 6 credits при 4K
  • Обработка: async, polling

Все показатели на этой странице взяты из документации API Photta · проверено

Короткий ответ

API виртуальной примерки — это HTTP-эндпоинт, выполняющий рендеринг одежды на модели. Вы отправляете фотографию товара — обычно уже имеющийся снимок в раскладке (flat lay) или на манекене — а сервис возвращает изображение этой одежды, надетой на человека. Никаких студий, поиска моделей и пересъемок при смене расцветки.

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

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

Эндпоинт, который выполняет задачу

Сгенерировано из документации Photta API, без ручных правок.

Коротко о главном

Эндпоинт
POST /api/v1/tryon/apparel
Аутентификация
API-ключ Bearer
Обработка
Асинхронно — опрашивайте эндпоинт статуса
Типичное время
1.5–4 min
Кредиты
5 credits при 2K · 6 credits при 4K
Соотношения сторон
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Ограничения на входные данные
До 10 МБ на изображение; JPEG, PNG, WebP
Идемпотентность
Нет

На что обращать внимание при выборе API виртуальной примерки

  • Что вы передаете

    Фотографию одежды в виде https URL или base64 data URI, а также параметры модели и позы. Photta принимает форматы JPEG, PNG и WebP размером до 10 MB на изображение.

  • Сколько времени это занимает

    Достаточно долго, чтобы операцию нельзя было выполнить в рамках одного веб-запроса. Photta публикует типичное время обработки для каждого эндпоинта и ожидает polling каждые 3 секунды — вебхуки не предусмотрены.

  • Сколько это стоит

    Photta списывает credits за каждый вызов: 5 при разрешении 2K и 6 при 4K для примерки одежды. Они снимаются при старте задачи и автоматически возвращаются при сбое.

  • Какие действуют лимиты

    Официальный rate limit составляет 600 запросов в минуту на один ключ, плюс действует ограничение тарифного плана на количество одновременных рендеров. С обоими лимитами стоит свериться перед пакетной обработкой каталога.

Первый запрос

Один и тот же вызов на cURL, Node.js и Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Вопросы об API виртуальной примерки

Что возвращает try-on API?

Изображение одежды на выбранной вами модели в виде URL внутри завершенной задачи. Скачайте и сохраните его — временный delivery URL не предназначен для постоянного хостинга.

Нужно ли мне фото модели?

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

Чем это отличается от виртуальной примерочной?

Примерочная — это пользовательский интерфейс для покупателя. Try-on API — лежащий под ним слой рендеринга: один вызов на входе, одно изображение на выходе. Вы можете построить поверх него примерочную или использовать его исключительно для генерации каталожных фото.

Сколько стоит один вызов try-on?

В Photta — 5 credits для 2K и 6 для 4K. За неудачные задачи credits возвращаются, поэтому стоимость повторного запроса равна стоимости самого запроса.

Сколько времени генерируется одно изображение?

Эндпоинт публикует ориентировочное время выполнения, а сама задача сообщает свой статус. Выполняйте polling каждые 3 секунды, а не закладывайтесь на фиксированное время.

Читать далее

Все показатели на этой странице взяты из документации API Photta · проверено

Попробуйте на фото собственного товара

Один запрос, один опрос, одно изображение.

Создать аккаунт и получить API-ключПосмотреть endpoint
  • 1.5–4 min
  • 5 credits при 2K · 6 credits при 4K
  • async, polling