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')

Возможности

Все эндпоинты по возможностям

Метод, путь, credits и стандартное время прямо из документации API. Данные на этой странице сверены с документацией на дату, указанную внизу.

Быстрый старт

От регистрации до первого изображения за пять минут.

У всех возможностей единый паттерн: авторизация, отправка, polling. Достаточно освоить один раз.

  1. Шаг 1: Зарегистрируйтесь на ai.photta.app и сгенерируйте боевой API-ключ в панели Developers.

  2. Шаг 2: Отправьте задачу через POST с вашим ключом в заголовке Authorization — API мгновенно вернёт ID генерации.

  3. Шаг 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. Все три варианта подробно описаны на этом сайте для каждой возможности.

Справочник

Разделы документации, к которым вы будете обращаться чаще всего.

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

Протестируйте API за пять минут

Сгенерируйте API-ключ Photta, вставьте пример cURL выше, и вы получите первое изображение на модели быстрее, чем сварится кофе.

  • 8 возможностей
  • 600 запросов/мин
  • Ключ Bearer
  • async, polling