Ваш путеводитель по API VoiceIt 2.
Так что же делает API 2 таким особенным?
Возможность идентифицировать и проверять по своему лицу и голосу…
API 2 обеспечивает возможность простой интеграции мультимодальной и многомодовой идентификации лица и голоса (1-к-n) и проверки (1-к-1).
Идентифицируйте или проверяйте пользователей по их лицу, голосу или лицу + голосу!
Где я могу использовать учетную запись разработчика VoiceIt?
Лучший вопрос - "Где его нельзя использовать?" Мы уже проделали за вас тяжелую работу. Вы получаете простой в использовании облачный RESTful API. Но под капотом скрываются все сложности центра биометрии лица и голоса.
Это означает, что нет предела. Если у чего-то есть камера, возможность записи звука или и то, и другое, с доступом в Интернет, вы можете защитить это с помощью VoiceIt.
Чаще всего клиенты используют VoiceIt как часть однофакторной или двухфакторной системы аутентификации на следующих платформах:
- Интерактивный голосовой ответ (IVR)
- Мобильные приложения (iOS, Android)
- Провайдеры веб-хостинга (Веб-сайты)
- Устройства, подключенные к Интернету (IoT)
Нет учетной записи разработчика? Подпишите здесь"!
Начало работы с API 2
Ниже мы расскажем, как начать использовать функцию проверки.
Определите, какие биометрические данные вы хотите использовать
С API 2 мы даем вам возможность проверять и идентифицировать пользователей по их лицу, голосу или лицу + голосу.
"Аутентификация"
VoiceIt использует ключ API и токен авторизации, чтобы разрешить доступ к API.
Пользователи
Мы упростили createUser
процесс, создав уникальный 36-значный буквенно-цифровой userId
для каждого пользователя.
Обязательно сохраните userId
, возвращаемый этим вызовом API, поскольку он необходим для всех будущих вызовов API, связанных непосредственно с этим профилем пользователя.
Зачисление
Давайте подробно рассмотрим регистрацию для каждого способа.
"Голос"
Мы рекомендуем использовать createVoiceEnrollment
, чтобы записать как минимум 3 голосовые фразы. Во время процесса адаптации вы хотите убедиться, что зачисление проходит качественно. Для этого вы можете использовать поле textConfidence
(ответа JSON) и проверить, что оно составляет 65% или выше. Если textConfidence
меньше 65%, вы должны удалить регистрацию, связанную с данным полем id
(ответа JSON). Как только у вас будет качественная регистрация, вы готовы к верификации пользователя.
"Лицо"
Рекомендуемый createFaceEnrollment
процесс состоит в том, чтобы снять двухсекундное видео, на котором пользователь смотрит в камеру, его лицо выделяется и находится в центре кадра видео.
Видео (Лицо + Голос)
Мы рекомендуем использовать createVideoEnrollment
для записи 3 видеороликов (каждое видео длительностью 5 секунд) с изображением лица пользователя и произнесением его голосовой фразы. Во время процесса адаптации вы хотите убедиться, что зачисление проходит качественно. Для этого мы используем распознавание лиц и textConfidence
(часть ответа JSON). Как только у вас будет качественная регистрация, вы готовы к верификации пользователя.
Проверка
"Голос"
voiceVerification
процесс прост и понятен. Как только у пользователя будет минимум 3 голосовых регистрации с фразой voiceprint, ее можно использовать для проверки. Ответ JSON содержит confidence
, responseCode
и textConfidence
. Эти три элемента можно использовать для определения успешной проверки, как и при проверке процесса регистрации.
"Лицо"
faceVerification
процесс настолько прост, насколько это возможно. Сделайте двухсекундное видео, на котором пользователь смотрит в камеру, лицо выделяется и находится в центре кадра.
Видео (Лицо + Голос)
videoVerification
процесс - вот где сияние мультимодальной биометрии. Как только у пользователя будет минимум 3 заявки на участие в видео с помощью голосовой фразы, ее можно использовать для проверки.
Захватите 5-секундное видео, содержащее лицо пользователя и фразу голосового текста, чтобы выполнить проверку видео.
Начать работу так же просто, как 1–2–3!
- Создайте нового пользователя с помощью
createUser
вызова RESTful API. Это возвращает новыйuserId
. - Зарегистрируйте пользователя с регистрацией видео 3 раза с помощью
createVideoEnrollment
илиcreateVideoEnrollmentByUrl
вызова RESTful API. Это создает новый шаблон регистрации для указанного профиля пользователя. - Подтвердите пользователя с помощью
videoVerification
илиvideoVerificationByUrl
вызова API RESTful. Это используется для проверки указанного профиля пользователя.
Параметры API
Параметры API VoiceIt гибкие, мощные и простые.
Голосовое подтверждение
Подтверждение лица
Видео (лицо + голос) проверка
Пример кода проверки видео
Следующие ниже фрагменты кода используют нашу NodeJS Wrapper для вызова нашего RESTful API.
Сначала инициализируйте оболочку NodeJS с помощью ключа API и токена.
Создать пользователя:
Используйте значение идентификатора пользователя, возвращаемое createUser()
, чтобы создать новую регистрацию видео для этого пользователя (создать не менее 3 заявок на пользователя):
Наконец, подтвердите пользователя через videoVerification
:
Где вы управляете своей интеграцией?
Все, что вам нужно для управления вашей интеграцией, доступно в нашей Консоли разработчика. Вот основные особенности:
"Управление пользователями"
Здесь можно найти и управлять всеми действиями, связанными с вашими пользователями. Создавайте, обновляйте и удаляйте пользователей по мере необходимости. Вы также можете проверить свою активность вызовов API.
Биллинг
VoiceIt с гордостью предлагает упрощенную многоуровневую модель ценообразования. Вы можете начать сегодня на нашем уровне бесплатного пользования.
На странице выставления счетов вы можете пополнить счет, настроить автоматическое пополнение счета, найти сводку использования и просмотреть свои прошлые платежи.
Голосовые фразы
Здесь вы можете управлять всеми собственными фразами. Чтобы получить подробное руководство о возможностях фраз для голосовой печати, вы можете проверить этот другой пост, который я написал.
"Приборная доска"
Просматривайте журнал активности пользователей API 2, чтобы легко устранять проблемы и быть в курсе производительности ваших приложений.
"Настройки"
Обновите сведения о компании и просмотрите свой ключ API и токен!
Документы
Чтобы получить доступ к документации по API 2, перейдите на api.voiceit.io.
Это источник документации API. Независимо от того, какой язык вы предпочитаете, у нас есть все необходимые оболочки и фрагменты кода.
У нас также есть отличные ресурсы на нашей странице GitHub, такие как iOS SDK, Android SDK и Web SDK. Это позволяет сэкономить время, копируя сегменты кода в новый или существующий проект.