API документация

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

1. 1

   Получите ключ

   Откройте кабинет разработчика и подайте заявку. Ключ выдаётся сразу — но в статусе «pending».

2. 2

   Дождитесь активации

   Мы свяжемся с вами для активации и оплаты. После — статус «active».

3. 3

   Сделайте первый запрос

   Передайте ключ в заголовке Authorization: Bearer и отправьте POST на /v1/identify.

curl -X POST https://bdkino.com/api/v1/identify \
  -H "Authorization: Bearer bdk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "robot collects garbage on an abandoned Earth",
    "lang": "en"
  }'

Аутентификация

Каждый запрос должен содержать заголовок с активным ключом. Без него — 401.

Authorization: Bearer bdk_live_xxxxxxxxxxxx

Эндпоинт: опознание фильма

Принимает изображение (base64) и/или текстовое описание сцены. Возвращает массив совпадений из базы bdkino, отсортированных по confidence-скору.

Параметры запроса

* Нужно передать минимум одно поле — image_base64 ИЛИ description (можно оба).

Пример: поиск по описанию

curl -X POST https://bdkino.com/api/v1/identify \
  -H "Authorization: Bearer bdk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "robot collects garbage on an abandoned Earth",
    "lang": "en"
  }'

Пример: поиск по кадру

# Закодируйте JPEG/PNG/WebP в base64 и подставьте вместо <BASE64>
curl -X POST https://bdkino.com/api/v1/identify \
  -H "Authorization: Bearer bdk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_base64": "<BASE64>",
    "lang": "en"
  }'

Формат ответа

{
  "found": true,
  "source": "text",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "results": [
    {
      "id": 10681,
      "media_type": "movie",
      "title": "WALL·E",
      "year": 2008,
      "overview": "In the distant future, a small waste-collecting robot...",
      "poster_url": "https://bdkino.com/api/img/w500/hbhFnRzhIxs...",
      "blur_b64": "data:image/webp;base64,UklGRk...",
      "vote_average": 8.0,
      "vote_count": 19234,
      "popularity": 87.5,
      "confidence": 0.91,
      "genres":             ["Animation", "Family", "Sci-Fi"],
      "keywords":           ["robot", "earth", "garbage", "love"],
      "cast":               ["Ben Burtt", "Elissa Knight", "Jeff Garlin"],
      "directors":          ["Andrew Stanton"],
      "origin_country":     ["US"],
      "original_language":  "en",
      "tagline":            "An adventure beyond the ordinary world.",
      "runtime":            98,
      "age_rating":         "G",
      "collection_id":      null,
      "collection_name":    null
    }
  ],
  "fallback_url": "https://bdkino.com/search"
}

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

Feedback: помогите обучить AI

После каждого вызова /v1/identify вы получаете request_id в ответе. Передайте его обратно с голосом «верно/не тот» — это попадёт в training set Cinemind. Бесплатный feedback loop повышает точность для всех.

Параметры (JSON body)

Пример

curl -X POST https://bdkino.com/api/v1/identify/feedback \
  -H "Authorization: Bearer bdk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: ru" \
  -d '{
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "vote": "yes",
    "id": 603,
    "media_type": "movie"
  }'

Ответ

{
  "ok": true,
  "vote": "yes",
  "training_pair_added": true,
  "message": "Спасибо! Ваш голос помогает обучить AI."
}

Коды ошибок

Все ошибки возвращают JSON вида {"detail":"<error_code>"}.

Лимиты и поведение

При 429 дождитесь начала следующего часа и повторите запрос; рекомендуем exponential backoff на стороне клиента.

Лучшие практики

Песочница

Решение проблем