> For the complete documentation index, see [llms.txt](https://docs.dbrain.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dbrain.io/obshaya-informaciya/trebovaniya-k-izobrazheniyam.md).
# Требования к изображениям
{% hint style="info" %}
Допустимые форматы, размер файла и HTTP-статусы описаны в разделе «Общая информация о сервисах». Здесь — только то, как должен выглядеть сам снимок.
{% endhint %}
### Коротко: что попросить у пользователя
1. Сфотографируйте **оригинал** документа. Не скриншот, не фото экрана, не ксерокопию.
2. Документ **целиком** в кадре. Поля не обрезаны краем и не закрыты пальцами.
3. Фото **цветное**, резкое, без бликов на ламинации.
4. Снимайте при нормальном свете, камеру держите **прямо над** документом.
5. Не сжимайте и не уменьшайте файл перед отправкой.
{% hint style="success" %}
Лучший сценарий — цветная фотография документа со смартфона. Скан тоже обрабатываем, но для антифрода надёжнее «живое фото».
{% endhint %}
### Файл
| Параметр | Требование |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Формат | JPEG, PNG, HEIC/HEIF, TIFF, BMP, GIF, WebP. Многостраничные файлы — PDF и DJVU |
| Размер файла | От 1 Кб до 30 Мб. Рекомендуем не меньше 100 Кб: меньше обычно значит, что фото сильно сжали |
| Цвет | Приоритет - цветные изображения. Чёрно-белые, сепия и фильтры камеры не подходят, могут давать худший результат. |
| Источник | Оригинал с камеры. Качественный скан. Плохой сценарий: скриншот, фото монитора или второго телефона, снимок бумажной копии |
{% hint style="warning" %}
Не отправляйте уменьшенную «для мессенджера» версию. Современные смартфоны дают достаточное разрешение даже с фронтальной камеры. Если изображение меньше 640 × 640 пикселей, проблема почти всегда в сжатии, а не в телефоне.
{% endhint %}
### Разрешение
Сервис ожидает изображение **не меньше 640 × 640 пикселей** (около 0,4 Мп). Это нижняя граница, при которой ещё можно что-то прочитать.
Для устойчивого извлечения данных рекомендуем **1 500–3 000 пикселей** по длинной стороне. Больше \~4 000 пикселей сервис уменьшит сам — сверхвысокое разрешение точность не повышает.
Для сканов в PDF ориентируйтесь на **300 DPI**.
### Кадр
* Весь документ в кадре, включая края бланка и машиночитаемую зону, если она есть.
* Документ занимает большую часть кадра. Не снимайте паспорт «с другого конца стола».
* Поля не закрыты пальцами, обложкой, скотчем, другим листом бумаги.
* Съёмка сверху, камера параллельна плоскости документа. Небольшой наклон сервис выправит. Сильный ракурс — уже нет: текст по краям перестанет читаться.
{% hint style="info" %}
Поворот на 90°, 180° или 270° можно не исправлять вручную. Зеркальные снимки тоже поправим. Главное — чтобы поля были в кадре и читались.
{% endhint %}
### Свет и резкость
* Ровный свет, без глубоких теней на тексте.
* Без бликов на ламинации. Особенно критичны ФИО, серия и номер, фото, машиночитаемая зона.
* Снимок резкий. Не снимайте на ходу и на длинной выдержке в темноте.
* Если в помещении темно — включите свет, вспышку или выйдите ближе к окну.
Ниже показаны примеры плохих фотографий, которые могут влиять на конечный результат сервисов:\
\
Поля закрыты пальцами. Нужен весь разворот, без перекрытий.
Смазанный кадр: данные не читаются, проверку запускать незачем.
Блики на ламинации закрывают поля.
### Что будет, если снимок плохой
В [Антифроде 2.0 ](/servisy/proverka-dokumentov/antifrod-2.0.md)такой файл получит `overall_result: bad_image_quality`. Это не вердикт о подделке. Это просьба прислать другое фото.
Причину смотрите в объекте `image.quality`:
| Параметр | Что не так | Что сказать пользователю |
| ------------------ | --------------------------------- | ---------------------------------------------------- |
| `blur_detected` | Снимок смазан | Держите камеру неподвижно и снимите ещё раз |
| `glare_detected` | Блики закрывают поля | Смените угол, уберите лампу из отражения |
| `document_cropped` | Документ обрезан или поля закрыты | Возьмите документ в кадр целиком, не закрывайте поля |
{% hint style="info" %}
Булевы флаги (`glare_detected`, `blur_detected`) довольно строгие. Если хотите пропускать лёгкий брак, ориентируйтесь на `glare_score`, `blur_score` и `crop_score`: от 0 до 1, чем ближе к единице, тем сильнее дефект.
{% endhint %}
### Что нельзя считать «нормальным фото»
Эти источники сервис распознаёт отдельно. Для [антифрода](/servisy/proverka-dokumentov/antifrod-2.0.md) это красные флаги:
| `image.origin` | Что это | Рекомендация |
| ------------------ | -------------------- | ----------------------------------------------------------------------------------- |
| `photo` | Фотография документа | Ожидаемый сценарий |
| `scan` | Скан | Решайте сами: для распознавания обычно достаточно, для антифрода слабее живого фото |
| `phone_screenshot` | Скриншот | Попросите фото оригинала |
| `monitor_photo` | Фото экрана | Попросите фото оригинала |
| `xerox` | Фото бумажной копии | Попросите фото оригинала |
### Как встроить это в продукт
1. Покажите пользователю короткие правила съёмки **до** загрузки файла. [Список из пяти](#korotko-chto-poprosit-u-polzovatelya) пунктов выше можно отдать как есть.
2. После ответа API смотрите `overall_result`. При `bad_image_quality` покажите конкретную причину из `image.quality` и попросите новый снимок для Антифрод 2.0. Или объекта `iqa` сервиса [извлечения данных](/servisy/izvlechenie-dannykh.md#kak-nachat-rabotat-s-servisom-izvlecheniya-dannykh).
3. Не смешивайте плохое качество с подделкой. Сначала получите нормальное фото, потом принимайте решение по фроду.
Подробнее про вердикты антифрода — в разделе Антифрод 2.0.
{% hint style="info" %}
[Все примеры сгенерированы, и предоставлены только виде примера, использование для теста не даст акутальный результ.](#user-content-fn-1)[^1]
{% endhint %}
[^1]:
---
# 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://docs.dbrain.io/obshaya-informaciya/trebovaniya-k-izobrazheniyam.md?ask=&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.
