# Advanced Event Understanding

## Introduction

Welcome to the Advanced Event Understanding API, a cutting-edge solution for sophisticated event analysis and interpretation. Our API harnesses the power of advanced AI technology to provide deep, real-time insights for your security and surveillance applications. By processing multiple images and associated metadata, our system offers unparalleled event comprehension, enabling you to make informed decisions quickly and efficiently.

## Key Features

* **Efficient Multi-Image Processing**: Analyze 5 or more strategic images per event, providing comprehensive understanding without the need for extensive data transfer.
* **Advanced AI Interpretation**: Extract deep insights from limited visual data, offering sophisticated event analysis that rivals full video processing.
* **Real-time Analysis**: Receive instant results for time-critical decision-making.
* **Flexible Integration**: Seamlessly incorporate our RESTful API into your existing systems.
* **Secure Communication**: Protect your data with robust API key authentication.

## Authentication

All API requests require authentication using an API key. Include your API key in the `x-api-key` header for all requests. If you don't have an API key, you can obtain one by contacting our support team at <support@traces.ai>.

## API Endpoints

{% openapi src="<https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2Fe9wxqsFHWfwLXzVy1Tlp%2Fswagger_codesamples.json?alt=media&token=89667d40-8b2e-4db7-8316-78382d6b3bc6>" path="/health" method="get" %}
[swagger\_codesamples.json](https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2Fe9wxqsFHWfwLXzVy1Tlp%2Fswagger_codesamples.json?alt=media\&token=89667d40-8b2e-4db7-8316-78382d6b3bc6)
{% endopenapi %}

{% openapi src="<https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2FRFsJ723mp5rtGbSZ7IHe%2Fswagger_codesamples.json?alt=media&token=4821a9a0-7f0a-4b5e-80a5-bf4aae62e01e>" path="/event/process" method="post" %}
[swagger\_codesamples.json](https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2FRFsJ723mp5rtGbSZ7IHe%2Fswagger_codesamples.json?alt=media\&token=4821a9a0-7f0a-4b5e-80a5-bf4aae62e01e)
{% endopenapi %}

{% openapi src="<https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2FRFsJ723mp5rtGbSZ7IHe%2Fswagger_codesamples.json?alt=media&token=4821a9a0-7f0a-4b5e-80a5-bf4aae62e01e>" path="/event/advanced\_understanding" method="get" %}
[swagger\_codesamples.json](https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2FRFsJ723mp5rtGbSZ7IHe%2Fswagger_codesamples.json?alt=media\&token=4821a9a0-7f0a-4b5e-80a5-bf4aae62e01e)
{% endopenapi %}

## Examples

<div align="left" data-full-width="true"><figure><img src="https://2748832723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McYmA310oN--gaDwXjq%2Fuploads%2FSiW8teq4uA0cHyPzS9Hp%2FEU_car_.gif?alt=media&#x26;token=e0600b8a-ccb1-4012-9e0e-8c9a38fba351" alt=""><figcaption><p>Input data</p></figcaption></figure></div>

{% code overflow="wrap" fullWidth="true" %}

```json
{
  "status": "completed",
  "result": {
    "event_summary": "A person wearing a light-colored hoodie approaches a black car parked on the side of a street. The person appears to attempt to open the side door, but the car is locked. The person gains entry to the car.",
    "predicted_attributes": {
      "people_descriptions": [
        "light-colored hoodie",
        "dark jeans"
      ],
      "people_actions": [
        "trying to break in"
      ],
      "logos": [
        "None"
      ],
      "vehicle_descriptions": [
        "a black car"
      ],
      "vehicle_actions": [
        "parked"
      ],
      "suspicion_status": "highly suspicious"
    }
  }
}
```

{% endcode %}

## Advanced Features

Our Advanced Event Understanding API offers a range of sophisticated capabilities:

1. **Multi-image Analysis**: Process 5 or more images per event for comprehensive understanding.
2. **Object Detection and Classification**: Identify and categorize objects, people, and vehicles in the scene.
3. **Action Recognition**: Understand and interpret the actions and behaviors of detected entities.
4. **Contextual Analysis**: Evaluate the overall situation and relationships between objects and actions.
5. **Natural Language Summaries**: Generate human-readable descriptions of events for quick comprehension.
6. **Suspicion Assessment**: Automatically evaluate the potential threat level of events.