Поиск по содержимому

Поиск по содержимому

POST /search/

Выполняет поиск по содержимому обработанных видео.

Тело запроса

Поиск по одной задаче:

{
    "query": "поисковая фраза",
    "job_id": "123e4567-e89b-12d3-a456-426614174000",
    "n_results": 5
}

Поиск по нескольким задачам:

{
    "query": "поисковая фраза",
    "job_ids": [
        "123e4567-e89b-12d3-a456-426614174000",
        "456e7890-e12b-34c5-d678-901234567890"
    ],
    "n_results": 10
}

Параметры

  • query - Поисковый запрос

  • job_id - UUID одной задачи (взаимоисключающе с job_ids)

  • job_ids - Массив UUID задач (взаимоисключающе с job_id)

  • n_results - Максимальное количество результатов (по умолчанию: 5)

Пример запроса

curl -X POST "https://your-domain.com/search/" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "машинное обучение",
    "job_id": "123e4567-e89b-12d3-a456-426614174000",
    "n_results": 5
  }'

Ответ

{
    "result": "ok",
    "data": [
        {
            "video_public_id": "request-id-uuid",
            "start_from": 45.5,
            "end_to": 67.2,
            "text": "В этом разделе мы рассмотрим основы машинного обучения",
            "similarity": 0.87,
            "image": "https://your-domain.com/frames/vendor-key/job-id/45"
        }
    ],
    "query": "машинное обучение",
    "total_results": 3
}

Описание полей ответа

  • result - Статус выполнения поиска (ok или error)

  • data - Массив результатов поиска

    • video_public_id - UUID запроса во внешней системе

    • start_from - Время начала найденного фрагмента (в секундах)

    • end_to - Время окончания найденного фрагмента (в секундах)

    • text - Найденный текстовый фрагмент

    • similarity - Коэффициент релевантности (от 0 до 1)

    • image - URL изображения кадра для данной временной метки (если доступны frames)

  • query - Оригинальный поисковый запрос

  • total_results - Общее количество найденных результатов

Особенности поиска

  1. Обогащение результатов - Если для задачи доступны кадры (frames), результаты автоматически дополняются ссылками на изображения

  2. Ранжирование - Результаты сортируются по релевантности (similarity)

  3. Контекст - Каждый результат включает временные рамки для точного позиционирования в видео

Ошибки поиска

При ошибке поиска API возвращает:

{
    "detail": "Search request failed: описание ошибки"
}

Возможные причины ошибок:

  • Задачи еще не обработаны полностью

  • Отсутствуют права доступа к указанным задачам

  • Проблемы с подключением к поисковому сервису

  • Некорректные параметры запроса

PreviousУправление задачамиNextWebhook уведомления