Украшения · Возможность

Jewelry Try-On API — Photta

Колье, кольца, браслеты и серьги на ИИ-моделях крупным планом. Алгоритмы оптимизированы для мелких и сильно отражающих поверхностей. Стоимость 2K/4K как у одежды, тот же асинхронный паттерн.

Суть

API примерки украшений Photta принимает фото изделия и `jewelry_type` (necklace, ring, bracelet или earrings) и возвращает макро-фото на модели. POST-запрос на `/api/v1/tryon/jewelry` с `Authorization: Bearer photta_live_xxx`, опрос ID каждые 3 секунды и скачивание результата при статусе `completed`.

Получить API-ключ→Документация
POST/api/v1/tryon/jewelry
cURL
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jewelry_type": "necklace",
    "jewelry_images": ["https://example.com/necklace.jpg"],
    "mannequin_id": "mnq_jewelry_close_01",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

Чего ожидать

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Код от и до

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

Те же три примера — просто измените эндпоинт и тело запроса.

SDK

→

Node.js

Native fetch · замените `/tryon/apparel` на `/tryon/jewelry` и готово

SDK

→

Python

requests + та же обертка photta.py · без лишних зависимостей

SDK

→

cURL

Тест за две минуты · идеально для проверки типов украшений

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

Процесс примерки одежды, перенастроенный для мелких блестящих предметов

Выберите макро-манекен, отправьте, опрашивайте, скачайте.

  1. 01

    Шаг 1

    Создайте API-ключ

    Так же, как и для одежды: ai.photta.app → Developers → Generate API key. Один ключ работает для всех эндпоинтов, один баланс кредитов на все возможности.

  2. 02

    Шаг 2

    Выберите макро-манекен

    Используйте фильтр `/api/v1/mannequins?jewelry_type=necklace` (или ring / bracelet / earrings) — Photta предлагает набор манекенов для крупных планов с текстурой кожи, оптимизированной под металл и камни.

  3. 03

    Шаг 3

    Отправьте задачу на украшение

    POST на `/api/v1/tryon/jewelry` с параметрами `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Сервис автоматически масштабирует объект под выбранную категорию.

  4. 04

    Шаг 4

    Опрашивайте до завершения задачи

    Делайте GET `/api/v1/tryon/jewelry/:id` каждые 3 секунды. Структура ответа идентична примерке одежды — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Шаг 5

    Скачайте и сохраните

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

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

Вопросы разработчиков перед запуском примерки украшений

Какие типы украшений поддерживаются?+

Четыре категории: necklace (колье), ring (кольцо), bracelet (браслет), earrings (серьги). Для каждой категории есть свои макро-манекены и эвристики размещения. Кольца и серьги лучше всего смотрятся в 1:1, колье — в 3:4.

Сколько стоит примерка украшений?+

Так же, как одежда: 5 кредитов за 2K, 7 кредитов за 4K. Ошибка в работе возвращает кредиты. Доплаты за использование библиотеки макро-манекенов нет.

Чем эндпоинт украшений отличается от одежды?+

Аутентификация, опрос и структура ответа те же — различия только в теле запроса. Вы отправляете `jewelry_type` и `jewelry_images` вместо `product_type` и `product_images`, и выбираете манекены с фильтром по категории украшений. Все остальное (2K/4K, формат, кредиты) едино.

Можно ли загрузить свою модель для украшений?+

Да — `/api/v1/jewelry-mannequins/upload` принимает референс макро-плана, а `/api/v1/jewelry-mannequins/generate` создает новую модель по промпту. Оба возвращают ID для использования в запросе.

Как обрабатываются металлы и камни с бликами?+

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

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

GET `/api/v1/tryon/jewelry/:id` каждые 3–5 секунд. Статусы те же: `processing` → `completed` или `failed`. Большинство задач завершается в окне от 1.5 до 4 минут.

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

Связанные возможности

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Украшения · Возможность

Создайте аккаунт и получите API-ключ

API примерки украшений Photta принимает фото изделия и `jewelry_type` (necklace, ring, bracelet или earrings) и возвращает макро-фото на модели. POST-запрос на `/api/v1/tryon/jewelry` с `Authorization: Bearer photta_live_xxx`, опрос ID каждые 3 секунды и скачивание результата при статусе `completed`.

Получить API-ключ →Тарифы
Jewelry Try-On API | Photta | Photta