Scanderm · проект sber_demo

Face Visualization API

Загрузите фото лица — получите набор визуализаций состояния кожи (морщины, поры, покраснения, жирный блеск, пигментация и др.) с баллами ML-моделей. REST и SSE, с возможностью «Try it Out» прямо здесь.

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

REST  Синхронно

POST /v1/visualize — один запрос с фото → JSON со всеми визуализациями и баллами (~15–25 c). Ниже в Swagger нажмите Try it Out.

SSE  Прогрессивно

GET /v1/visualize/stream/{session_id} — каждая визуализация прилетает событием по мере готовности. Живой пример — в блоке 3.

Аутентификация — заголовок X-Internal-Key. Для этого демо-стенда ключ проекта sber_demo уже подставлен (в Swagger и в живом примере). Ключ ограничен только API визуализации.

2Какие визуализации вернутся (module = face)

До 16 карточек за запрос. Каждая — готовая склейка «кроп лица + оверлей» (image_url, JPEG, presigned-ссылка) + балл score 0–10.

idПризнакENТип
skin_uniformityОднородность тонаSkin uniformityТепловая карта + легенда
oily_shineЖирный блескOily shineТепловая карта
scarsПостакнеPost-acneМаска зон
wrinklesМорщиныWrinklesМаска линий
rednessПокрасненияRednessМаска + легенда
poresПорыPoresМаска
papulesВоспаления (папулы)PapulesМаска элементов
pustulesПустулыPustulesМаска элементов
comedonsКомедоныComedonesМаска + легенда
dark_circlesТёмные круги под глазамиDark circlesКонтур зоны + шкала
dehydrationОбезвоженностьDehydrationТепловая карта
dullnessТусклость кожиDullnessТепловая карта + легенда
erythemЭритемаErythemaМаска
teleКуперозTelangiectasiaМаска + легенда
orientation_fieldПоле ориентации порPore orientation fieldВекторный оверлей
wrinkle_forecastПрогноз морщинWrinkle forecastПрогнозный оверлей

3Live SSE demo

Swagger «Try it Out» не умеет рисовать живой SSE-поток. Этот блок шлёт реальные запросы (GET /stream + POST /visualize) и отрисовывает визуализации по мере готовности.

Лучше всего — фронтальное фото лица при ровном свете. JPEG/PNG/WebP, до 10 МБ.
Какие визуализации запросить выбрать все · снять все
Передаётся в запрос как ?visualizations=<id,id,…> — и REST, и SSE вернут только выбранное. Пусто = все.
готов к запуску…

4Полная спецификация (REST + SSE)