Ghost Mannequin · Возможность

Ghost Mannequin API — Photta

Удаление манекена с фото с сохранением внутренней структуры изделия — швов, подкладки, бирок. Режим hollow-man или flat-lay, готовность к пакетной обработке, 4 кредита за 2K.

Суть

API ghost mannequin принимает фото одежды на манекене и возвращает изображение с «невидимым» манекеном и восстановленной внутренней частью изделия. Отправьте POST на `/api/v1/ghost-mannequin` с `product_image_url`, `style` (hollow_man или flat_lay) и разрешением. Опрашивайте `/api/v1/ghost-mannequin/:id` каждые 3 секунды до статуса `completed`.

Получить API-ключ→Документация

POST/api/v1/ghost-mannequin

cURL

curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://example.com/tshirt-on-model.jpg",
    "style": "hollow_man",
    "resolution": "2K"
  }'

Чего ожидать

Typical completion

1–3min

2K / 4K credits

4 / 6

Styles

Batch-ready

yes

Код от и до

Выберите язык

Тот же REST-контракт; эндпоинт ghost mannequin также поддерживает пакетную обработку для массового обновления каталогов.

SDK

→

Node.js

Native fetch · отлично сочетается с BullMQ или Inngest для фоновых задач

SDK

→

Python

requests + asyncio для параллельной отправки запросов

SDK

→

cURL

Идеально для проверки пакетов данных перед внедрением

Как это работает

Одно фото на входе, одно фото с «невидимкой» на выходе

Загрузите исходник, выберите стиль, отправьте, опрашивайте, скачайте.

01
Шаг 1
Создайте API-ключ
Ghost mannequin использует те же учетные данные, что и другие функции Photta — один ключ, один баланс кредитов.
02
Шаг 2
Загрузите исходное фото
Вы можете передать публичный URL в `product_image_url` или загрузить файл через `/api/v1/uploads`. Поддерживаются JPG, PNG и WebP.
03
Шаг 3
Отправьте задачу ghost mannequin
POST на `/api/v1/ghost-mannequin` с `product_image_url`, `style` (hollow_man или flat_lay) и `resolution`. Можно указать `webhook_url` для уведомления о завершении, хотя опрос остается основным методом.
04
Шаг 4
Опрашивайте до завершения задачи
GET `/api/v1/ghost-mannequin/:id` каждые 3 секунды. Этот процесс быстрее примерки — обычно 1–3 минуты — так как не требуется рендеринг человека.
05
Шаг 5
Скачайте и сохраните
На выходе вы получаете PNG с удаленным манекеном и дорисованной изнанкой. Идеально для карточек товаров с 3D-эффектом и flat-lay вставок.

Вопросы других разработчиков

Вопросы разработчиков перед запуском ghost mannequin

Что такое фотография ghost mannequin?+

Это подача товара, при которой одежда «парит» на невидимом теле, демонстрируя форму и изнанку одновременно. Обычно это требует склейки нескольких студийных снимков; API Photta делает это за один вызов из одного фото на манекене.

Сколько стоит ghost mannequin?+

4 кредита за 2K, 6 кредитов за 4K — на один кредит дешевле примерки на каждом уровне. Неудачные попытки возвращаются на баланс.

В чем разница между стилями hollow-man и flat-lay?+

Hollow-man сохраняет 3D-форму манекена: у одежды остается объем, плечи и рукава выглядят естественно, изнанка восстанавливается. Flat-lay «сплющивает» одежду в аккуратную 2D-раскладку, что удобно для капсульных коллекций или маркетплейсов с единым стандартом фронтального вида.

Можно ли обрабатывать несколько фото пачкой?+

Да. Отправьте POST на `/api/v1/ghost-mannequin/batch` с массивом исходных изображений. В ответ придет batch ID и индивидуальные ID генераций. Опрашивайте общий статус через `/api/v1/ghost-mannequin/batch/:id` или каждый элемент отдельно.

Сохраняются ли внутренние швы и бирки?+

Да — модель восстанавливает реальную изнанку (горловину, манжеты, пояс), а не генерирует абстрактную поверхность. Бирки и логотипы, видимые на оригинале, по возможности сохраняются.

Как опрашивать результат?+

GET `/api/v1/ghost-mannequin/:id` каждые 3 секунды. Для пакетов опрашивайте родительский эндпоинт, который возвращает общий прогресс и детализацию по каждому объекту.

Связанные темы