> 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="https://2041336905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHLoHbtSPFA1Ul7oKM5SC%2Fuploads%2F1wEQd8Jbf4IOBPopcaXZ%2Ffacematching%20ru-scheme-v8.drawio.svg?alt=media&amp;token=e963367d-42e8-4b25-8ef6-2de6c151f05e" 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 в ваше веб-приложение](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/kak-integrirovat-oz-liveness-v-vashe-veb-prilozhenie.md)

[Как интегрировать Oz Liveness в ваше мобильное приложение](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/kak-integrirovat-oz-liveness-v-vashe-mobilnoe-prilozhenie.md)

В данном сценарии описывается, как загрузить референтное фото в ту же папку, где находится снятое ранее 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`).

Коллекция 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
