Руководство · Невидимый манекен

Что такое ghost mannequin API? кадр с эффектом невидимого манекена

В двух словах

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

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

Типичное время: 1.5–4 min
Кредиты: 4 credits при 2K · 5 credits при 4K
Обработка: async, polling

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

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

Съемка на невидимом манекене (ghost mannequin, hollow man) показывает одежду, сохраняющую форму без тела внутри. Традиционно это собирается на постпродакшене из нескольких студийных кадров: вещь на манекене, удаление манекена и последующее вклеивание внутренней части воротника и манжет.

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

Это стандартная подача для карточек товаров (PDP) в категории одежды, поэтому основные потребители — команды каталогов и маркетплейсы, которым нужен единый вид тысяч позиций без бронирования студии под каждую вещь.

Эндпоинт, выполняющий операцию

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

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

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

На что обращать внимание при выборе ghost mannequin API

Что вы отправляете
Одежду, сфотографированную на манекене, плюс опциональный вид сзади. Photta принимает JPEG, PNG и WebP размером до 10 MB на изображение.
Какой результат вы получаете
Эндпоинт Photta принимает стиль: 3d сохраняет трехмерный объем вещи, flat_lay раскладывает ее в аккуратный фронтальный флэтлей.
Сколько это стоит
4 credits за 2K и 5 за 4K на Photta — на один credit дешевле, чем try-on на каждом уровне, с автоматическим возвратом при сбое задачи.
Поддерживаются ли пакеты
Каталожные съемки идут партиями, а не поштучно. У Photta есть пакетный эндпоинт, который принимает массив, резервирует credits заранее и отдает статус по каждому объекту.

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

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

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
    "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
    "image_side": "front",
    "angle": "side",
    "style": "3d",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "user_instruction": "closed front, cream interior lining",
    "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front",
      "angle": "side",
      "style": "3d",
      "background_color": "white",
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "user_instruction": "closed front, cream interior lining",
      "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Вопросы о ghost mannequin API

Что такое ghost mannequin фото?

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

Что отправлять в эндпоинт?

Фотографию вещи на манекене. Вид сзади опционален и улучшает реконструкцию, если вещь расстегнута или двусторонняя.

Что выбрать: 3d или flat lay?

3d — когда нужно передать объем надетой вещи: плечи, рукава, форму. flat_lay — когда для витрины требуется строгая фронтальная раскладка, что часто требуют маркетплейсы.

Сколько стоит одно изображение?

На Photta — 4 credits за 2K и 5 за 4K. В батче та же цена за изображение резервируется заранее на весь объем.

Можно ли обработать весь каталог?

Да, через пакетный эндпоинт. Размер батча и лимит параллельных батчей зависят от вашего тарифа, поэтому большой каталог прогоняется последовательностью батчей.

Читать далее

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

Обработайте одну вещь для проверки

Одно фото на входе, один готовый кадр на невидимом манекене на выходе.

Создать аккаунт и получить API-ключ Посмотреть endpoint

1.5–4 min
4 credits при 2K · 5 credits при 4K
async, polling