Перейти к основному содержимому

Начало работы

GVR предоставляет REST API для анализа голоса, изображений и данных об именах и имен. В этой документации описаны аутентификация, форматы запросов, квоты и конечные точки API, необходимые для интеграции в рабочую среду.

Базовый URL​

Все пути API в этой документации указываются относительно адреса:

https://api.genderrecognition.com

Разделы API​

API для голоса​

  • API определения пола по голосу
  • API определения возраста по голосу
  • API обнаружения поддельного голоса
  • API распознавания эмоций в речи
  • API проверки качества аудио
  • API проверки личности говорящего

API для работы с голосом принимают аудиофайлы. Для API определения пола по голосу также доступен URL аудиозаписи.

API для изображений​

  • API определения пола по изображению
  • API определения возраста по изображению

API для работы с изображениями принимают файлы JPEG, PNG, WebP, BMP или GIF и возвращают прогноз пола или возраста и процент уверенности для каждого обнаруженного лица или человека.

API для анализа имён​

  • API определения пола по имени
  • API оценки возраста по имени
  • API определения этнической принадлежности по имени
  • API определения языка по имени
  • API анализа имён в CSV

API для отдельных имён принимают JSON с полями имени и фамилии. Обработка CSV принимает файлы в формате multipart.

Модель аутентификации​

API для разработчиков используют заголовок запроса apiKey:

apiKey: YOUR_API_KEY

Не передавайте ключи API из общедоступного кода браузера. По возможности используйте серверную интеграцию для отправки запросов.

Первый запрос​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"

Следующие шаги​

  1. Прочитайте раздел «Аутентификация».
  2. Создайте ключ API в приложении GVR.
  3. Ознакомьтесь с разделом «Квоты и использование».
  4. Откройте руководство по API, которое хотите интегрировать.