Анализ контента и рекомендации по API
ДАРА анализирует видео, изображения, аудио и тексты вашего сайта — речь, кадры, смысл — и по API строит персональную ленту, похожие, переранжирование и поиск. У каждого объекта в выдаче есть причина.
1Объект
Как выбрать горный велосипед
2Результаты анализа
3Выдача с причинами
01
Шесть возможностей одного API. Ответы — JSON, у выдачи всегда есть recommendation_id для метрик и объяснение reason.
Главная, «для вас», бесконечная прокрутка. Новые посетители получают тренды и свежее, постоянные — ленту по интересам.
POST /recommendations/feed
{"user": {"user_id": "u-501"}, "limit": 24}Ответ
{"recommendation_id": "01JC8Z6Q9W3M5N7P2R4T6V8X0Y",
"items": [{"id": "v-2210", "score": 0.91, "reason": "interest"},
{"id": "v-1877", "score": 0.84, "reason": "together"}],
"has_more": true, "mode": "personal", "identity": "user"}Блок под плеером или карточкой товара — по смыслу содержания, а не только по тегам. Работает сразу после загрузки объекта.
POST /recommendations/similar
{"item": "v-1042", "user": {"anonymous_id": "a-7f3c2e"}, "limit": 8}Ответ
{"recommendation_id": "01JC8ZC2D3E4F5G6H7J8K9M0NP",
"items": [{"id": "v-0977", "score": 0.88, "reason": "similar"},
{"id": "v-1310", "score": 0.73, "reason": "author"}],
"mode": "personal", "identity": "anonymous"}Похожие для всей корзины: то, что покупают вместе с этими товарами, для корзины важнее замен.
POST /recommendations/similar
{"items": ["sku-3107", "sku-2240"], "limit": 4,
"user": {"user_id": "u-501"}}Ответ
{"recommendation_id": "01JC8ZD5X7Y9Z1A3B5C7D9E1F3",
"items": [{"id": "sku-5120", "score": 0.79, "reason": "together"},
{"id": "sku-4471", "score": 0.61, "reason": "similar"}],
"mode": "personal", "identity": "user"}Ваш список — каталог, подборка, результаты своего поиска — в порядке интереса конкретного пользователя.
POST /recommendations/rerank
{"user": {"user_id": "u-501"}, "items": ["n-11", "n-12", "n-13"]}Ответ
{"recommendation_id": "01JC8ZE8Q2R4S6T8V0W2X4Y6Z8",
"items": [{"id": "n-13", "score": 0.82},
{"id": "n-11", "score": 0.47},
{"id": "n-12", "score": 0.12}],
"identity": "user"}Находит фразу из середины видео и возвращает фрагмент со временем — плеер можно открыть на нужной секунде.
POST /search
{"query": "как настроить тормоза", "limit": 20}Ответ
{"recommendation_id": "01JC8ZF1G3H5J7K9M1N3P5Q7R9",
"items": [{"id": "v-1042", "score": 0.86,
"matches": [{"media_position": 0, "start_sec": 402.5,
"end_sec": 431.0, "text": "…тормоза в два шага…"}]}],
"has_more": false, "identity": "none"}Субтитры VTT и SRT, описание, теги, возрастная отметка и модерация — для карточек, SEO и проверки контента.
GET /items/v-1042
Ответ
{"id": "v-1042", "status": "ready",
"summary": {"description": "Обзор рам, вилок и тормозов…",
"tags": ["велоспорт", "снаряжение", "обзор"],
"age_rating": "0+", "moderation": {"level": "none"}}}02
Четыре шага от каталога до выдачи. Всё, что делает сайт, — отправляет данные и запрашивает выдачу по API.
Ролики, товары, статьи, треки с медиа по https-ссылкам. Повторная отправка безопасна: объект заменяется, а анализ перезапускается только для изменившегося.
Речь — транскрипт с таймкодами, кадры — что в кадре и текст на экране, сводка — темы, теги, возраст, модерация, векторы — смысл для похожих и поиска.
Показы, досмотры, лайки, корзина и заказы. Плюс то, что сайт знает сам: интересы из анкеты, возраст, город, любимые авторы.
Лента, похожие, переранжирование и поиск за доли секунды. У каждого объекта — причина: интерес, «вместе», автор, тренд, свежее.
Анонимные посетители
Посетитель без входа узнаётся по id, который выдаёт ваш сайт, — например, из cookie. При желании клиента — ещё и через DARA Fingerprint. Когда посетитель входит, его история переходит в аккаунт, а на общем устройстве чужая история не подмешивается.
03
Проект начинается с пресета: он задаёт типы событий и их веса. Веса и типы потом можно менять.
Пресет «Видеохостинг»
Пресет «Магазин»
Пресет «Медиа»
04
Для каждой задачи проект выбирает облачную модель или локальную, которая работает на сервере ДАРА и ничего не отправляет наружу. Речь, кадры и сводку можно не выполнять.
Транскрипт с таймкодами, субтитры VTT и SRT
Можно не выполнять
В облаке
OpenAI gpt-transcribe
На сервере ДАРА
Whisper large-v3-turbo (int8, CPU)
Что в кадре, текст в кадре, флаги безопасности
Можно не выполнять
В облаке
OpenAI gpt-5.6-luna — кадры
На сервере ДАРА
Быстрый анализ кадров (OCR, теги, безопасность)
Описание, темы, теги, возрастная отметка, модерация
Можно не выполнять
В облаке
OpenAI gpt-5.6-luna — сводка
На сервере ДАРА
Локальная instruct-модель 3–4 млрд (GGUF Q4)
Смысл объекта для ленты, похожих и поиска
Нужны выдаче всегда
В облаке
OpenAI text-embedding-3-large (1024)
На сервере ДАРА
multilingual-e5-small (384)
Если облачный шаг получает результат локального — например, транскрипт уходит в облачную сводку, — кабинет предупредит об этом. Модели выбираются в настройках проекта, есть готовые наборы «Всё в облаке» и «Всё локально».
05
Передайте объект, отправьте события, запросите ленту. Ключ проекта — в заголовке, API работает только с вашего сервера.
1Объект
curl -X PUT https://core.daratech.ru/api/v1/items/v-1042 \
-H "Authorization: Bearer $DARA_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "video", "title": "Как выбрать горный велосипед",
"author": "channel-17",
"media": [{"kind": "video", "url": "https://cdn.example.ru/v-1042.mp4"}]}'2События
curl -X POST https://core.daratech.ru/api/v1/events \
-H "Authorization: Bearer $DARA_KEY" \
-H "Content-Type: application/json" \
-d '{"events": [{"id": "evt-88122", "type": "watch", "item": "v-1042",
"user": {"user_id": "u-501"}, "value": 540}]}'3Лента
curl -X POST https://core.daratech.ru/api/v1/recommendations/feed \
-H "Authorization: Bearer $DARA_KEY" \
-H "Content-Type: application/json" \
-d '{"user": {"user_id": "u-501"}, "limit": 24}'06
Доступ выдаётся по заявке. Стоимость обсуждается при подключении и зависит от объёма контента и выбранных моделей. Онлайн-оплаты нет.
Вопросы — info@daratech.ru