> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge-ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/sravnenie-lic/kak-sravnit-lico-iz-snyatogo-dlya-proverki-liveness-video-s-licom-iz-vashei-bazy-dannykh.md).

# Как сравнить лицо из снятого для проверки Liveness видео с лицом из вашей базы данных

В этой статье вы узнаете, как сравнить лицо из готового Liveness-видео с лицом на референтной фотографии, сохраненной в вашей базе данных.

{% hint style="warning" %}
Обратите внимание: инструкции применимы для версий, которые не работают с контейнером данных.
{% endhint %}

<figure><img src="/files/0rDfYAamxEppure6Ws8a" alt=""><figcaption></figcaption></figure>

Если вы хотите провести сравнение с использованием фото документа вместо изображения из базы данных, соответствующая инструкция находится [здесь](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/sravnenie-lic/kak-dobavit-semku-dokumenta-i-vozmozhnost-sopostavleniya-lic-v-vashe-veb-ili-mobilnoe-prilozhenie.md).

К этому моменту вы, скорее всего, уже разобрались с тем, как снимать видео и проводить Liveness-проверки. Если нет, пожалуйста, ознакомьтесь со статьями:

* [Интеграция Oz Liveness Web SDK](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-web-prilozhenie.md)
* [Интеграция Oz Liveness Mobile SDK](https://app.gitbook.com/o/-MQv6kXBVXmdGRKx4Fy8/s/HLoHbtSPFA1Ul7oKM5SC/~/changes/373/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-mobilnoe-prilozhenie)

В данном сценарии описывается, как загрузить референтное фото в ту же папку, где находится снятое ранее Liveness-видео, запустить анализ BIOMETRY и получить результаты.

#### 1. Получите идентификатор папки, где находится нужное видео — `folder_id`

Сравнение лиц должно происходить в одной папке, поэтому вам необходим идентификатор папки, где лежит нужное вам Liveness-видео. Получите идентификатор папки, как показано ниже, и передайте его на свой бэкенд.

* Для видео, записанного через Web SDK, процесс получения идентификатора папки описан [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/rekomendacii-po-bezopasnosti.md).
* Для видео, записанного через наши мобильные SDK, получите идентификатор папки из результатов анализа:

**Android**:

{% tabs %}
{% tab title="Kotlin" %}

```kotlin
AnalysisRequest.Builder()
        ...
        .run(object : AnalysisRequest.AnalysisListener {
            override fun onSuccess(result: List<OzAnalysisResult>) {
                // сохраните folder_id, он потребуется далее
                val folderId = result.firstOrNull()?.folderId
            }
            ...
        })
```

{% endtab %}

{% tab title="Java" %}

```java
private void analyzeMedia(List<OzAbstractMedia> mediaList) {
    new AnalysisRequest.Builder()
            ...
            .run(new AnalysisRequest.AnalysisListener() {
                @Override public void onStatusChange(@NonNull AnalysisRequest.AnalysisStatus analysisStatus) {}
                @Override
                public void onSuccess(@NonNull List<OzAnalysisResult> list) {
                    String folderId = list.get(0).getFolderId();
                    }
                }
                ...
    });
}
```

{% endtab %}
{% endtabs %}

**iOS**:

<pre class="language-swift"><code class="lang-swift">analysisRequest.run(
scenarioStateHandler: { state in }, 
uploadProgressHandler: { (progress) in }  
)   { (analysisResults : [OzAnalysisResult], error) in 
        // сохраните folder_id, он потребуется далее
        let folderID = analysisResults.first?.folderID
    }
<strong>}
</strong></code></pre>

#### 2. Загрузите в папку референтное фото из своей базы данных

Вызовите [метод](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#e239f619-1aa7-41cb-b098-071c83a7b960) `POST /api/folders/{{folder_id}}/media/`. Замените `folder_id` на полученный на предыдущем шаге идентификатор папки. Так ваше изображение попадет в папку с нужным видео.

Установите в запросе теги в соответствии с тем, что за фото вы загружаете — фото документа или селфи. Это нужно сделать в поле Payload.

```json
{
  "media:tags": { 
    "photo1": [
        "photo_id", "photo_id_front" // для фото лицевой стороны документа
        // ИЛИ
        "photo_selfie" // для фото, не являющегося документом
    ]
  }
}
```

#### 3. Запустите анализ

Для запуска анализа вызовите [метод](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#92f3494c-affd-45dd-8cbb-60eb19d1d2d9) `POST /api/folders/{{folder_id}}/analyses/`. Замените `folder_id` на полученный ранее идентификатор папки. В теле запроса укажите анализ BIOMETRY.

```json
{
    "analyses": [
        {
            "type": "biometry"
        }
    ]
}
```

#### 4. Запустите опрос для получения результатов

Раз в секунду отправляйте [запрос](https://documenter.getpostman.com/view/23712118/2s93m1Z4bP#3326291e-181e-49e3-80fb-db981d492d13) `GET /api/analyses/{{analyse_id}}` с полученным ранее `analyse_id`, пока состояние анализа не изменится с `PROCESSING` на какое-либо другое. Когда анализ завершится, вы можете оценить результаты:

* качественные — в resolution (`SUCCESS` или `DECLINED`).
* количественные — в `analyses.results_data.min_confidence`

Коллекция Postman для описанных в статье шагов.

{% file src="/files/3iAJLYSHXPSKbfHYdsuf" %}

Эти шаги помогут вам провести сравнение лиц с использованием Oz API. Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь [веб-консолью](/oz-knowledge-ru/rukovodstva/rukovodstvo-polzovatelya/oz-webui.md) или API-запросами.

Детальную информацию о том, как применять инструменты Oz API, вы можете найти в [руководстве разработчика](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/sravnenie-lic/kak-sravnit-lico-iz-snyatogo-dlya-proverki-liveness-video-s-licom-iz-vashei-bazy-dannykh.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
