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

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

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

Muapi раскрывает это через AI Dress Change, единую конечную точку, которая принимает model_image_url и Clothes_image_url и возвращает составной результат — один ключ API, один поток запросов/опросов, оплата по факту использования.

Виртуальная примерка или фотография продукта

Это смежные, но разные намерения. Виртуальная примерка берет существующее изображение человека и меняет его на другую одежду — результатом является визуализация посадки/образа этого конкретного человека или модели. Фотография продукта создает новые изображения продукта, готовые для каталога, с нуля, с быстро управляемым фоном и освещением, без обязательного размещения их на фиксированном человеке. Используйте виртуальную примерку, чтобы показать покупателю, как на нем выглядит одежда; используйте фотографии продукта, чтобы создать чистую рекламу или фотографию продукта, отражающую образ жизни. Сравнить с фотографией продукта →

Ключевые возможности

Получение хорошего качества ввода и результатов позы

• Используйте четкую фотографию модели, обращенную вперед. Один человек, хорошее освещение и нейтральная поза или поза стоя дают модели четкое представление о том, где должна сидеть одежда.
• Изолируйте одежду. Плоский снимок или снимок манекена с минимальными помехами на фоне обеспечивает более точную передачу текстуры и формы, чем фотография одежды, сфотографированная на другом человеке.
• Соотнесите категорию одежды с покрытием тела. Топы, платья и верхняя одежда обычно переносятся надежнее, чем сложные многослойные наряды; перед пакетной обработкой протестируйте свой конкретный каталог.
• Ожидайте некоторой итерации. Как и в любой модели генеративного изображения, результаты варьируются от запуска к запуску — рассматривайте первый результат как черновик и повторно запускайте его с более чистым исходным изображением, если оно подходит или текстура не подходит.

Конфиденциальность и согласие

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

Как вызвать API виртуальной примерки

1. Разместите оба изображения. Загрузите фотографию модели и фотографию одежды через POST /api/v1/upload_file или используйте любой общедоступный URL-адрес.
2. Отправьте запрос. Вызовите POST /api/v1/ai-dress-change с помощью model_image_url и Clothes_image_url.
3. Опрос для завершения. Проверяйте GET /api/v1/predictions/{request_id}/result до тех пор, пока статус не будет завершен, а затем загрузите составное изображение.

curl -X POST https://api.muapi.ai/api/v1/ai-dress-change \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model_image_url": "https://example.com/model-photo.jpg",
    "garment_image_url": "https://example.com/garment-photo.jpg"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-dress-change",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "model_image_url": "https://example.com/model-photo.jpg",
        "garment_image_url": "https://example.com/garment-photo.jpg",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Часто задаваемые вопросы