> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Загрузка лица пользователя через API: профиль vendor_data > Загрузите изображение лица в base64 в существующий профиль пользователя Didit после создания или импорта пользователя с vendor_data. Промпт для загрузки лица пользователя Скопировать промпт в буфер обмена \

\`Goal: Attach a trusted imported face image to an existing Didit User profile.

Use case: I am migrating users from another provider. I already have a stable vendor_data and a face image I am allowed to process. I want the User profile to carry that face for evidence, duplicate detection, and face search.

Flow:
1\. Create or retrieve the User by vendor_data:
POST https://verification.didit.me/v3/users/create/
GET  https://verification.didit.me/v3/users/{vendor_data}/
2\. Read didit_internal_id from the User response.
3\. Upload the face to:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

Auth: x-api-key for the same application.
Content-Type: application/json

Request body:
\- image (string, required) — raw base64-encoded JPG or PNG. Do not include a data URL prefix. Max decoded size: 2 MB.
\- comment (string, optional) — operator-visible note, for example "Imported from previous KYC provider".

Response 201:
\{
"uuid": "face-upload-uuid",
"image_url": "https://signed-url.example/...",
"comment": "Imported from previous KYC provider",
"uploaded_by": "api",
"created_at": "2026-05-18T12:00:00Z"
}

Limits:
\- Max 5 manually uploaded faces per User.
\- The image must decode as an image and contain a detectable face.
\- This enrolls the face for profile evidence and matching. It does not add the face to a blocklist.

To block a face, use POST /v3/lists/{list_uuid}/entries/face-upload/ with a face-type list instead.`

\
Вставьте в ## ОбзорИспользуйте этот endpoint, когда импортируете пользователей от другого провайдера и уже располагаете доверенным изображением лица для каждого человека. Пользователь по-прежнему определяется вашим `vendor_data`, но этот endpoint прикрепления профиля использует `didit_internal_id`, чтобы целевой пользователь определялся однозначно.> [!NOTE] > > Это отличается от [загрузки лица в список](https://docs.didit.me/ru/management-api/lists/upload-face.md). Загрузка в профиль прикрепляет лицо к пользователю для использования в качестве подтверждения, обнаружения дубликатов и поиска по лицу. Загрузка в список добавляет лицо в список блокировки по лицам, чтобы будущие сессии сопоставления можно было отклонять.## Endpoint**`POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/`**## Процесс миграции**1. Создание или поиск пользователя**Вызовите [`POST /v3/users/create/`](https://docs.didit.me/ru/management-api/users/create) для нового профиля или [`GET /v3/users/{vendor_data}/`](https://docs.didit.me/ru/management-api/users/get) для существующего.**2. Сохранение didit\_internal\_id**Ответ с данными пользователя содержит `didit_internal_id`. Продолжайте использовать `vendor_data` в своей базе данных, а `didit_internal_id` применяйте только в endpoints прикрепления профиля.**3. Загрузка лица**Отправьте необработанную строку base64 с изображением в поле `image`. Перед сохранением бэкенд проверяет декодирование изображения, его размер и обнаружение лица.## Пример```bash theme={null} # 1. Create the User keyed by your external id curl -X POST https://verification.didit.me/v3/users/create/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "vendor_data": "user-42", "display_name": "Jane Doe", "metadata": { "previous_provider": "legacy-kyc-vendor" } }' # 2. Upload an imported face to the returned didit_internal_id curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/$DIDIT_INTERNAL_ID/faces/upload/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "image": "", "comment": "Imported from previous KYC provider" }' ```## Тело запроса| Поле | Тип | Обязательно | Описание | | - | - | - | - | | `image` | string | Да | Необработанная строка base64 в формате JPG или PNG. Не включайте `data:image/...;base64,`. Максимальный размер после декодирования: 2 МБ. | | `comment` | string | Нет | Примечание для оператора, которое отображается в профиле пользователя. |## Ответ```json theme={null} { "uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "image_url": "https://signed-url.example/face.jpg", "comment": "Imported from previous KYC provider", "uploaded_by": "api", "created_at": "2026-05-18T12:00:00Z" } ```## Проверки и ограничения- Не более 5 лиц, загруженных вручную, на одного пользователя. - Максимальный размер декодированного изображения: 2 МБ. - Изображение должно быть корректной строкой base64 и декодироваться как изображение. - На изображении должно быть обнаруживаемое лицо. По возможности используйте кадрированный снимок лица анфас при хорошем освещении. - Загруженное лицо индексируется для последующего обнаружения дубликатов и поиска по лицу. - Загруженное лицо автоматически не добавляется в список блокировки.## Просмотр и удаление загруженных лицПолучить список лиц профиля:```bash theme={null} curl https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/$DIDIT_INTERNAL_ID/faces/ \ -H "x-api-key: YOUR_API_KEY" ```Удалить одно лицо профиля:```bash theme={null} curl -X DELETE https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/$DIDIT_INTERNAL_ID/faces/$FACE_UUID/ \ -H "x-api-key: YOUR_API_KEY" ```## РазрешенияИспользуйте API-ключ для того же приложения. Ключ должен принадлежать приложению, которому разрешено управлять профилем целевого пользователя.## Сбои- `400`: неверный base64, неверное изображение, лицо не обнаружено, изображение больше 2 МБ или у пользователя уже 5 загруженных лиц. - `401`: учетные данные отсутствуют или недействительны. - `403`: API-ключ действителен, но не имеет права управлять этим профилем пользователя. - `404`: в приложении нет пользователя с таким `didit_internal_id`. - `429`: превышен лимит запросов; повторите запрос позже, используя `Retry-After`.## Связанные материалы- [Создание пользователя](https://docs.didit.me/ru/management-api/users/create.md) - [Получение пользователя](https://docs.didit.me/ru/management-api/users/get.md) - [Импорт и экспорт пользователей](https://docs.didit.me/ru/entities/users/import-export.md) - [Лица и биометрия](https://docs.didit.me/ru/entities/users/faces-and-biometrics.md) - [Загрузка лица в список блокировки](https://docs.didit.me/ru/management-api/lists/upload-face.md) ## OpenAPI ````yaml ru/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/: post: tags: - Users summary: Загрузить лицо пользователя description: >- Прикрепить доверенное импортированное изображение лица к существующему профилю пользователя. Используйте этот метод после создания или получения пользователя по `vendor_data` и чтения его `didit_internal_id`. Загруженное лицо сохраняется в профиле пользователя и индексируется для обнаружения дубликатов и поиска по лицу. Оно не добавляется в список блокировки лиц. operationId: upload_user_face parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID организации, владеющей приложением. - name: application_id in: path required: true schema: type: string format: uuid description: UUID приложения, которому принадлежит профиль пользователя. - name: didit_internal_id in: path required: true schema: type: string format: uuid description: >- Внутренний UUID пользователя Didit, возвращаемый как `didit_internal_id` методами `GET /v3/users/{vendor_data}/` и `POST /v3/users/create/`. requestBody: required: true content: application/json: schema: type: object required: - image properties: image: type: string format: byte description: >- Необработанное изображение лица в формате JPG или PNG в кодировке base64. Не включайте префикс `data:image/...;base64,`. Максимальный размер после декодирования: 2 МБ. comment: type: string description: >- Необязательная видимая оператору заметка для загруженного лица. default: '' examples: Imported face: summary: Прикрепить лицо, импортированное от предыдущего провайдера value: image: /9j/4AAQSkZJRgABAQEA... comment: Imported from previous KYC provider responses: '201': description: Лицо загружено и прикреплено к профилю пользователя. content: application/json: schema: type: object required: - uuid - image_url - comment - uploaded_by - created_at properties: uuid: type: string format: uuid description: UUID загруженной записи лица пользователя. image_url: type: string format: uri nullable: true description: Подписанный URL для загруженного изображения лица. comment: type: string nullable: true description: Комментарий, указанный при загрузке лица. uploaded_by: type: string nullable: true description: >- Электронная почта или идентификатор пользователя, выполнившего загрузку, если доступны. created_at: type: string format: date-time description: Временная метка загрузки. examples: Uploaded: value: uuid: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee image_url: https://signed-url.example/face.jpg comment: Imported from previous KYC provider uploaded_by: api created_at: '2026-05-18T12:00:00Z' '400': description: >- Недопустимое тело запроса или изображение. Распространённые причины: некорректный base64, некорректное изображение, лицо не обнаружено, размер изображения более 2 МБ, отсутствует эмбеддинг или у пользователя уже загружено 5 лиц. content: application/json: examples: No face: value: image: >- No face detected in the image. Please upload a clear photo with a visible face. Too many faces: value: detail: Maximum of 5 faces per user reached. Too large: value: image: Image exceeds maximum size of 2 MB. '401': description: Отсутствует или недействителен API-ключ. content: application/json: examples: Missing key: value: detail: Authentication credentials were not provided. '403': description: >- Учетные данные действительны, но не могут записывать профили пользователей для этого приложения. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: В приложении нет пользователя с таким `didit_internal_id`. content: application/json: examples: Not found: value: detail: Not found. '429': description: >- Лимит запросов превышен; снизьте частоту запросов и повторите попытку. content: application/json: examples: Rate limited: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/vendor-users/by-id/f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418/faces/upload/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"image": "/9j/4AAQSkZJRgABAQEA...", "comment": "Imported from previous KYC provider"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.users.upload_face( "11111111-2222-3333-4444-555555555555", image="/9j/4AAQSkZJRgABAQEA...", comment="Imported from previous KYC provider", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.users.uploadFace("11111111-2222-3333-4444-555555555555", { image: "/9j/4AAQSkZJRgABAQEA...", comment: "Imported from previous KYC provider", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Users.UploadFace(ctx, \"11111111-2222-3333-4444-555555555555\", didit.UsersUploadFaceParams{\n\tImage: \"/9j/4AAQSkZJRgABAQEA...\",\n\tComment: didit.String(\"Imported from previous KYC provider\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.UsersUploadFaceParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.users().uploadFace("11111111-2222-3333-4444-555555555555", UsersUploadFaceParams.builder() .image("/9j/4AAQSkZJRgABAQEA...") .comment("Imported from previous KYC provider") .build()); System.out.println(result); - lang: php label: PHP source: >- users->uploadFace('11111111-2222-3333-4444-555555555555', [ 'image' => '/9j/4AAQSkZJRgABAQEA...', 'comment' => 'Imported from previous KYC provider', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.users.upload_face( "11111111-2222-3333-4444-555555555555", image: "/9j/4AAQSkZJRgABAQEA...", comment: "Imported from previous KYC provider" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Users.UploadFaceAsync("11111111-2222-3333-4444-555555555555", new UsersUploadFaceParams { Image = "/9j/4AAQSkZJRgABAQEA...", Comment = "Imported from previous KYC provider", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.