{
  "info": {
    "_postman_id": "bdkino-api-v1",
    "name": "bdkino API · v1",
    "description": "Identify movies by frame or text description.\n\nSet the collection variable `api_key` to your active key from /developer.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      { "key": "token", "value": "{{api_key}}", "type": "string" }
    ]
  },
  "variable": [
    { "key": "base_url", "value": "https://bdkino.com/api", "type": "string" },
    { "key": "api_key",  "value": "bdk_live_xxxxxxxxxxxx", "type": "string", "description": "Get one at /developer" }
  ],
  "item": [
    {
      "name": "Identify · by description",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"description\": \"robot collects garbage on an abandoned Earth\",\n  \"lang\": \"en\"\n}"
        },
        "url": {
          "raw": "{{base_url}}/v1/identify",
          "host": [ "{{base_url}}" ],
          "path": [ "v1", "identify" ]
        },
        "description": "Search by free-form scene description (10–2000 chars)."
      }
    },
    {
      "name": "Identify · by image (base64)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"image_base64\": \"<paste base64 of JPEG/PNG/WebP, max 15MB>\",\n  \"lang\": \"en\"\n}"
        },
        "url": {
          "raw": "{{base_url}}/v1/identify",
          "host": [ "{{base_url}}" ],
          "path": [ "v1", "identify" ]
        },
        "description": "Search by single frame. JPEG quality 80 at 1280×720 is optimal."
      }
    },
    {
      "name": "Identify · combined (image + description)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"image_base64\": \"<paste base64>\",\n  \"description\": \"futuristic city neon lights cyberpunk\",\n  \"lang\": \"ru\"\n}"
        },
        "url": {
          "raw": "{{base_url}}/v1/identify",
          "host": [ "{{base_url}}" ],
          "path": [ "v1", "identify" ]
        },
        "description": "Highest accuracy: combine image + description. lang=ru returns titles in Russian."
      }
    }
  ]
}