Photta API
Photta API Виртуальный try-on, ghost mannequin и предметная съёмка через REST
В двух словах
Photta API — это REST API с оплатой в credits: отправьте фото товара через POST на эндпоинт возможности, опрашивайте статус эндпоинта каждые несколько секунд, скачайте готовое изображение. Восемь возможностей, один ключ, общий баланс credits.
- Возможности: 8 возможностей
- Rate limit: 600 запросов/мин
- Аутентификация: Ключ Bearer
- Паттерн: async, polling
Все показатели на этой странице взяты из документации API Photta · проверено
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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]Возможности
Все эндпоинты по возможностям
Метод, путь, credits и стандартное время прямо из документации API. Данные на этой странице сверены с документацией на дату, указанную внизу.
- POST/api/v1/tryon/apparel
Virtual Try-On (Одежда)
Переносите раскладку (flat-lay) одежды на AI-манекен с выбранной мимикой и комплекцией. Четыре типа товаров, пять соотношений сторон.
5 credits при 2K · 6 credits при 4K1.5–4 min
Посмотреть endpoint - POST/api/v1/tryon/jewelry
Jewelry Try-On
Крупные планы колье, колец, браслетов и серег на специализированных манекенах для украшений — с точной проработкой бликов и мелких деталей.
5 credits при 2K · 6 credits при 4K1.5–4 min
Посмотреть endpoint - POST/api/v1/ghost-mannequin
Невидимый манекен (Ghost Mannequin)
Удаляйте манекен с фото одежды с сохранением внутренней структуры вещи. 3D- или flat-lay результат, поддержка пакетной обработки.
4 credits при 2K · 5 credits при 4K1.5–4 min
Посмотреть endpoint - POST/api/v1/ghost-mannequin/batch
Пакетный Ghost Mannequin
Отправляйте целую партию фото одежды одним запросом и отслеживайте через один ID пакета; расчет credits и статус ведутся для каждого изображения отдельно.
4 credits при 2K · 5 credits при 4K1.5–4 min per image
Посмотреть endpoint - POST/api/v1/eyewear-studio
Eyewear Studio
Обычные и солнцезащитные очки на моделях крупным планом с точным сохранением оправы из исходного фото товара.
5 credits при 2K · 6 credits при 4K20–60 sec
Посмотреть endpoint - POST/api/v1/detail-photos
Детальные снимки
Макроснимки швов, ткани, фурнитуры и бирок по одному фото товара; встроенный анализатор подскажет, какие зоны стоит снять.
3 credits20–60 sec
Посмотреть endpoint - POST/api/v1/mannequins/generate
Генерация манекенов
Создавайте собственных манекенов для одежды или украшений по параметрам и используйте их ID в каждом вызове try-on.
4 credits30-60s
Посмотреть endpoint - POST/api/v1/workflows/{workflow_id}
Воркфлоу
Запускайте готовые воркфлоу — например, имиджевый hero shot для украшений — в один вызов и получайте готовый набор изображений.
4 credits при 2K · 5 credits при 4K20–60 sec / image
Посмотреть endpoint
Языки
SDK пока нет — и он вам не нужен.
Три готовых руководства в формате «скопировал и запустил», точно по текущей документации Photta.
Node.js
Node.js
Нативный fetch в Node 18+, хелпер на 20 строк, готов к Next.js server actions.
ЧитатьPython
Python
Библиотека requests + обёртка на 30 строк. Работает в Django, FastAPI, Celery, Lambda.
ЧитатьcURL
cURL
Двухминутный смоук-тест любого эндпоинта. Подходит для пайплайнов в shell в связке с jq.
Читать
Быстрый старт
От регистрации до первого изображения за пять минут.
У всех возможностей единый паттерн: авторизация, отправка, polling. Достаточно освоить один раз.
Шаг 1: Зарегистрируйтесь на ai.photta.app и сгенерируйте боевой API-ключ в панели Developers.
Шаг 2: Отправьте задачу через POST с вашим ключом в заголовке Authorization — API мгновенно вернёт ID генерации.
Шаг 3: Выполняйте polling того же эндпоинта каждые 3 секунды, пока статус не сменится на completed, затем скачайте результат по URL.
Вопросы
О чём разработчики спрашивают перед регистрацией
Что такое Photta API?
Photta API — это REST-сервис с оплатой в credits, который генерирует профессиональные фэшн-фотографии из снимков ваших товаров. Это тот же пайплайн, на котором работают пользовательские приложения Photta: виртуальный try-on одежды, примерка украшений и создание снимков на невидимом манекене (ghost mannequin). Для разработчиков он открыт в виде восьми возможностей, поверх которых можно строить свои инструменты.
Как получить API-ключ?
Зарегистрируйтесь на ai.photta.app, перейдите в раздел Developers панели управления и нажмите Generate API key. Боевой ключ начинается с `photta_live_`, за которым следуют 32 шестнадцатеричных символа. Храните его в переменной окружения — никогда не коммитьте в репозиторий и не передавайте в браузер.
Есть ли бесплатный тариф?
Новые аккаунты получают пробные credits, которые можно потратить на любую возможность. Когда будете готовы к запуску, перейдите на тариф с большим ежемесячным объёмом credits. Ограничение rate limit одинаково на всех тарифах: 600 запросов в минуту на один API-ключ. Никаких минимальных лимитов на вызовы нет.
Сколько времени занимает генерация?
Задачи try-on и ghost mannequin обычно выполняются за 1.5–4 минуты; фото очков, детальная съёмка и рабочие кадры — за 20–60 секунд; генерация манекена — за 30–60 секунд. Все эндпоинты генерации асинхронные: POST сразу возвращает ID генерации, после чего вы опрашиваете статус (polling) каждые 3–5 секунд до завершения задачи. Держать долгоживущее HTTP-соединение не нужно.
Есть ли официальный Photta SDK?
Пока нет. Поддерживаемый способ интеграции — чистый REST через cURL, нативный fetch в Node или библиотеку requests в Python. Все три варианта подробно описаны на этом сайте для каждой возможности.
Справочник
Разделы документации, к которым вы будете обращаться чаще всего.
Справочник
Первое изображение в Photta менее чем за 5 минут.
Зарегистрируйтесь, сгенерируйте API-ключ, выполните первый вызов cURL, опрашивайте статус до завершения, сохраните результат. 5 шагов с полным описанием.
ЧитатьСправочник
Аутентификация в Photta API
Как проходить аутентификацию в Photta API: заголовок Authorization, префикс ключа, где создаются ключи и как безопасно выполнить их ротацию.
ЧитатьСправочник
Тарифы Photta API
Сколько стоит каждый endpoint Photta API в credits при 2K и 4K, как устроены списания и возвраты, и какие эндпоинты бесплатны. Никаких цен в деньгах за изображение.
ЧитатьСправочник
Rate limits в Photta API
Rate limit Photta API, его окно, заголовок Retry-After, интервал polling и ограничения параллелизма по планам — прямо из документации API.
ЧитатьСправочник
Ошибки Photta API
Полный список типов ошибок Photta API с их статус-кодами, формат тела ошибки и сбои, которые имеет смысл повторять.
ЧитатьСправочник
Эндпоинты ресурсов Photta API
Получайте списки манекенов, поз, фонов, обуви и лейблов брендов, загружайте собственные и проверяйте баланс кредитов. Справочники, на которых строится каждая генерация.
ЧитатьГайды
Что такое API виртуальной примерки?
API виртуальной примерки переносит одежду на модель по одной фотографии товара. Что требуется на входе, что на выходе, сколько это стоит и сколько времени занимает.
ЧитатьГайды
Что такое ghost mannequin API?
Ghost mannequin API удаляет манекен с фотографии одежды и дорисовывает внутреннюю часть. Входные данные, формат ответа и стоимость.
ЧитатьГайды
Миграция с FASHN на Photta
Что меняется при переносе интеграции виртуального try-on с FASHN на Photta: аутентификация, тело запроса, polling и списание credits.
ЧитатьРазработка
Разработка с Photta API
Восемь готовых рецептов для Photta API: приложение виртуальной примерки try-on, приложение для Shopify, плагин для WooCommerce, воркер на Django, пакетная обработка каталогов и no-code автоматизация.
ЧитатьСравнение
Лучшие API для виртуальной примерки
Как работают пять API виртуальной примерки — Photta, FASHN, FitRoom, Pixazo и Ayna. Что публикует каждый вендор, что скрывает, и где ознакомиться с деталями.
Читать
Все показатели на этой странице взяты из документации API Photta · проверено
Протестируйте API за пять минут
Сгенерируйте API-ключ Photta, вставьте пример cURL выше, и вы получите первое изображение на модели быстрее, чем сварится кофе.
- 8 возможностей
- 600 запросов/мин
- Ключ Bearer
- async, polling