Photta API
ИИ-фотосессии для моды за один REST-вызов.
Генерируйте фото одежды и украшений на моделях, удаляйте манекены с flat-lay снимков и создавайте собственную ИИ-фотостудию на базе продакшн-пайплайна Photta — асинхронные REST-эндпоинты, оплата кредитами, документация с упором на cURL.
Возможности
3
Auth
Bearer
Паттерн
Async + poll
Типично
1–4 min
Возможности
Три эндпоинта, один аккаунт, один баланс кредитов.
Все возможности используют общую аутентификацию, паттерн опроса (polling) и структуру ошибок — изучите один, внедрите все три.
Виртуальная примерка (Одежда)
Разместите одежду с flat-lay на ИИ-манекене с нужной позой, мимикой и телосложением. Шесть типов товаров, пять соотношений сторон.
Примерка украшений
Крупные планы колье, колец, браслетов и серег на специализированных ИИ-манекенах — корректная обработка отражений и мелких деталей.
Ghost Mannequin
Удаляйте манекен с фото одежды, сохраняя внутреннюю структуру изделия. Результат в стиле hollow-man или flat-lay, подходит для пакетной обработки.
Языки
SDK пока нет — и он вам не нужен.
Три готовых примера интеграции, которые точно соответствуют актуальным рекомендациям Photta.
Быстрый старт
От регистрации до первого изображения за пять минут.
Все возможности следуют одному паттерну: аутентификация, отправка, опрос. Выучите один раз.
- 1Зарегистрируйтесь на ai.photta.app и создайте live API-ключ в панели Developers.
- 2Отправьте POST-запрос с вашим ключом в заголовке Authorization — API сразу вернет ID генерации.
- 3Опрашивайте тот же эндпоинт каждые 3 секунды, пока статус не станет completed, затем скачайте результат по ссылке.
curl -X POST \
https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["..."],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K"
}'Вопросы
Что разработчики спрашивают перед регистрацией
Что такое Photta API?+
API Photta — это REST-сервис с оплатой кредитами, который генерирует профессиональный контент из ваших фото товаров. Это тот же пайплайн, на котором работают пользовательские приложения Photta: виртуальная примерка одежды, украшений и ghost mannequin, доступные в виде трех эндпоинтов для создания ваших собственных инструментов.
Как получить API-ключ?+
Зарегистрируйтесь на ai.photta.app, откройте раздел Developers в панели управления и нажмите Generate API key. Ваш live-ключ начинается с `photta_live_`, за которым следуют 32 шестнадцатеричных символа. Храните его в переменной окружения — никогда не фиксируйте в Git и не передавайте в браузер.
Есть ли бесплатный тариф?+
Новые аккаунты получают пробные кредиты для тестирования любой возможности. Когда будете готовы к запуску, выберите план с увеличенным лимитом кредитов и более высокими лимитами частоты запросов (30/min Starter, 60/min Pro). Минимального порога вызовов нет; неиспользованные кредиты не сгорают внутри расчетного периода.
Как быстро происходит генерация?+
Задачи на примерку обычно выполняются от 1.5 до 4 минут. Ghost mannequin работает быстрее — обычно 1–3 минуты. Каждый эндпоинт асинхронен: POST возвращает ID генерации менее чем за секунду, после чего вы опрашиваете API каждые 3–5 секунд до завершения задачи. Нет необходимости поддерживать долгое HTTP-соединение.
Есть ли официальный Photta SDK?+
Пока нет. В планах выпуск Python SDK после появления десяти активных клиентов API, и Node.js SDK — после двадцати. До этого момента рекомендуемый путь интеграции — прямой REST через cURL, native fetch в Node или библиотеку requests в Python. Все три варианта подробно описаны здесь.
Photta API
Попробуйте API за пять минут
Создайте API-ключ Photta, вставьте cURL-команду, и вы получите первое изображение на модели быстрее, чем сварится кофе.