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

Создание подключения

При создании телефонного канала вы можете подключить собственный аккаунт одного из провайдеров распознавания и синтеза речи. Для этого перейдите на вкладку ASR/TTS и в поле Подключение выберите Создать подключение. Затем выберите провайдера и заполните настройки подключения.

Обратите внимание, что если вы используете ASR/TTS одного провайдера, то нет необходимости создавать подключение повторно. Создайте подключение, например, для ASR, а затем в разделе TTS выберите подключение из списка.

подсказка
Если для ASR/TTS вы используете собственное подключение, использование минут ASR/TTS Just AI для вас не тарифицируется.

ASR/TTS Google​

Для подключения ASR/TTS Google вам необходимо создать JWT Token. Для этого:

  1. Перейдите в Cloud Console, далее нажмите IAM & Admin на левой панели. Здесь также на левой панели выберите Service Accounts.
  2. Нажмите Select a project, выберите проект и нажмите Open.
  3. Найдите строку учетной записи, для которой вы хотите создать ключ. В этой строке нажмите на иконку , в выпадающем списке нажмите Create key.
  4. Выберите тип ключа и нажмите Create. Созданный ключ будет сохранен на ваш компьютер.
подсказка
Вы можете создать JWT Token для ASR/TTS Google другими способами, подробнее об этом читайте здесь.

Обратите внимание, что формат ключа может отличаться в зависимости от способа его создания. Ключи, созданные при помощи Cloud Console, выглядят следующим образом:

{
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\nprivate-key\n-----END PRIVATE KEY-----\n",
  "client_email": "service-account-email",
  "client_id": "client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/service-account-email"
}

Теперь загрузите ключ в настройки подключения при создании канала в JAICP, нажмите Сохранить.

ASR/TTS Yandex​

Для подключения ASR/TTS Yandex вам необходимо создать закрытый ключ сервисного аккаунта, а также скопировать идентификаторы каталога, открытого ключа и сервисного аккаунта.

Закрытый ключ сервисного аккаунта​

Если у вас еще нет сервисного аккаунта, создайте его и назначьте ему роли.

Чтобы создать ключ сервисного аккаунта:

  1. Перейдите в каталог, которому принадлежит сервисный аккаунт.
  2. Выберите вкладку Сервисные аккаунты.
  3. Выберите сервисный аккаунт и нажмите на строку с его именем.
  4. Нажмите кнопку Создать новый ключ на верхней панели. Выберите пункт Создать авторизованный ключ.
  5. Задайте описание ключа, чтобы потом было проще найти его в консоли управления.
  6. Сохраните идентификатор и секретный ключ.
подсказка
Вы можете создать закрытый ключ сервисного аккаунта для ASR/TTS Yandex другими способами, подробнее об этом читайте здесь.

Формат закрытого ключа сервисного аккаунта:

-----BEGIN PRIVATE KEY-----EXAMPLE1234567G9w0BAQEFAASCBKgwggS
cmQxJjAkBgNVBAoTHVByb2dyZXNzIFNvZnR3YXJlIENvcnBvcmF0aW9uMSAwHgYD
VQQDDBcqLmF3cy10ZXN0LnByb2dyZXNzLmNvbTCCASIwDQYJKoZIhvcNAQEBBQAD
...
EXAMPLE1234567YWxzaGEyZzIuY3JsMIGgBggrBgEFBQcBAQSBkzCBkDBNBggrBgEF
BQcwAoZBaHR0cDovL3NlY3VyZS5nbG9iYWxzaWduLmNvbS9jYWNlcnQvZ3Nvcmdh
z3P668YfhUbKdRF6S42Cg6zn-----END PRIVATE KEY-----

Идентификаторы сервисного аккаунта и открытого ключа​

  1. Перейдите в каталог, которому принадлежит сервисный аккаунт.
  2. Выберите вкладку Сервисные аккаунты.
  3. Выберите сервисный аккаунт и нажмите на строку с его именем.
  4. Идентификатор сервисного аккаунта смотрите в разделе Обзор.
    Формат идентификатора сервисного аккаунта: example0mjt06siua65usm.
  5. Идентификатор открытого ключа смотрите в разделе Авторизованные ключи напротив названия созданного ранее ключа.
    Формат идентификатора открытого ключа: example0mjt06siua65usm.

Идентификатор каталога​

  1. Откройте страницу каталога. Вы можете выбрать каталог на стартовой странице консоли управления. На этой странице отображаются каталоги для выбранного облака. Если необходимо, переключитесь на другое облако.
  2. Получите идентификатор каталога из URL страницы каталога в консоли управления: https://console.cloud.yandex.ru/folders/example1234567: здесь идентификатор каталога — example1234567.

Теперь заполните поля в настройках подключения при создании канала в JAICP, нажмите Сохранить.

ASR Tinkoff​

Для подключения ASR Tinkoff вам необходимо создать авторизационный токен. Подробнее о том, как создать авторизационный токен, читайте в документации Tinkoff VoiceKit.

В настройках подключения при создании канала в JAICP в поле Ключ API вставьте API_KEY, а в поле Ключ — SECRET_KEY. Нажмите Сохранить.

ASR/TTS 3iTech​

Для подключения ASR/TTS 3iTech провайдер предоставляет платформу 3i VOX, где вам потребуется получить авторизационный токен.

  1. Зарегистрируйтесь на сайте 3i VOX и подтвердите регистрацию.
  2. Авторизуйтесь на сайте 3i VOX и перейдите в раздел API.
  3. Нажмите Authorize. Будет выведено модальное окно для сохранения данных авторизации.
  4. Под названием аккаунта в правом верхнем углу нажмите Для разработчиков.
  5. Вставьте идентификатор клиента и авторизационный ключ в поля Username и Password.
  6. Нажмите Authorize, чтобы сохранить введенные данные, и закройте модальное окно.
  7. В выпадающем списке Servers переключите сервер на /oauth.
  8. В разделе oauth2 раскройте метод /token и выберите Try it out для выполнения запроса.
  9. Задайте следующие параметры запроса:
    • grant_type — password.
    • username — логин от вашей учетной записи.
    • password — пароль от вашей учетной записи.
  10. Нажмите Execute, чтобы выполнить запрос.

Если все сделано верно, то запрос должен вернуть ответ следующего вида:

{
  "token_type": "Bearer",
  "access_token": "93CF267BB3034CDA8E2B00409C",
  "scope": "vox"
}
подсказка
При заполнении настроек подключения в JAICP вставьте в поле Токен значение access_token.

ASR/TTS Azure​

Чтобы подключить ASR/TTS Azure, вам потребуется учетная запись Microsoft Azure.

Если у вас есть корпоративная подписка на Microsoft 365, вы также можете настроить доступ к сервисам Azure через Azure Active Directory, которая бесплатно включена в вашу подписку.

подсказка
Подробнее об интеграции Azure с Microsoft 365

Весь процесс подключения включает в себя следующие этапы:

  1. Чтобы ресурсы Azure стали для вас доступны, создайте подписку для своего аккаунта.
  2. Ресурсы Azure существуют внутри групп ресурсов. Создайте новую группу для будущего сервиса.
  3. Создайте в группе новый ресурс, включающий в себя сервис Речь.
  4. Используйте ключ и регион ресурса для настройки подключения в JAICP.

Если у вас уже есть подписка, группа ресурсов или нужный ресурс, пропустите соответствующий шаг.

Подписка​

Авторизуйтесь на портале Azure. Чтобы использовать необходимые ресурсы Azure, в том числе ресурс для распознавания и синтеза речи, аккаунт должен иметь активную подписку.

Чтобы создать новую подписку:

  1. Перейдите на страницу Подписки.
  2. Нажмите Добавить и выберите нужную подписку.
  3. Дайте согласие на условия использования подписки.
  4. Если подписка платная, привяжите ее к платежному счету.

Если у вас нет прав на создание подписок в вашем каталоге, обратитесь к администратору каталога.

Группа ресурсов​

Все связанные между собой ресурсы в Azure создаются в рамках групп ресурсов.

Чтобы создать новую группу ресурсов:

  1. Перейдите на страницу Группы ресурсов и нажмите Создать.

  2. На вкладке Основные заполните поля:

    • Подписка — подписка, в рамках которой будет тарифицироваться группа ресурсов.

    • Группа ресурсов — название новой группы ресурсов.

    • Регион — регион, где будет выделена инфраструктура Azure для группы ресурсов.

      подсказка

      Следует выбирать регион, максимально близкий к локации инфраструктуры, которая будет конечным потребителем ресурсов, — это снизит влияние сетевых задержек. Кроме того, учитывайте требования местного законодательства к местонахождению центров обработки данных.

      • Рекомендуемый регион для российской установки — northeurope (Северная Европа).
      • Для европейской установки — germanywestcentral (Центрально-Западная Германия).

  3. При необходимости заполните вкладку Теги.

  4. Нажмите Просмотр и создание, затем Создать. Группа ресурсов будет создана.

Ресурс​

Создайте в группе новый ресурс, включающий в себя сервис Речь.

подсказка
Речь — пакет средств для синтеза и распознавания речи, а также определения языка, перевода устной речи и других функций. Подробнее о сервисе Речь
  1. Перейдите в созданную группу ресурсов и нажмите Создать.
  2. Найдите в каталоге и выберите сервис Речь.
  3. На вкладке Basics заполните поля:
    • Подписка, Группа ресурсов и Регион заполните так же, как для группы ресурсов.
    • Имя — название нового ресурса.
    • Ценовая категория — вариант оплаты ресурса (подробнее о ценах здесь).
  4. На вкладке Сеть оставьте публичный доступ. При необходимости заполните другие вкладки.
  5. Нажмите Проверка и создание, затем Создание. Ресурс будет создан и запущен.

Настройки подключения Azure​

Теперь все готово для того, чтобы создать и настроить подключение.

После создания ресурса нажмите Перейти к ресурсу и перейдите на вкладку Ключи и конечная точка. В настройках подключения ASR/TTS Azure в JAICP используйте данные с этой страницы:

  • Ключ ресурса может быть любым из двух доступных ключей.
  • Регион ресурса должен совпадать с регионом, где расположен ресурс.

Наличие двух ключей обеспечивает бесперебойность подключения. Если один из ключей нужно перевыпустить, используйте другой ключ для подключения — так его работоспособность не будет прервана.

Ключи, регион и конечная точка ресурса Azure

ASR/TTS SaluteSpeech от Сбера​

Чтобы создать подключение ASR/TTS SaluteSpeech в JAICP, вам нужно подключить сервис SaluteSpeech и пройти аутентификацию. На этапе аутентификации вы получите Client ID и Client Secret для вашего приложения.

подсказка
Подробнее о подключении и аутентификации см. в документации SaluteSpeech.

При создании канала в JAICP в настройках подключения ASR укажите:

  • Scope — тип сервиса:
    • SALUTE_SPEECH_PERS — для физических лиц.
    • SALUTE_SPEECH_CORP — для юридических лиц.
    • SBER_SPEECH — устаревшее значение для юридических лиц.
  • Client ID.
  • Client Secret.

Если вы хотите использовать TTS SaluteSpeech, перейдите на вкладку TTS, выберите созданное подключение, а затем код голосовой модели. Каждый код соответствует голосу. Примеры голосов и их соответствие кодам вы можете найти в документации SaluteSpeech.

предупреждение
В JAICP вы можете использовать только голосовые модели с частотой 8 кГц. Коды таких моделей заканчиваются на «_8000».

ASR Kaldi​

предупреждение
По умолчанию Kaldi недоступен для выбора в качестве провайдера. Обратитесь к аккаунт-менеджеру, если хотите, чтобы его можно было выбрать.

Вы можете развернуть собственный сервис для распознавания речи, использующий open-source библиотеку Kaldi, и подключить его к проектам на JAICP. JAICP сможет работать с вашей реализацией сервиса, если она работает по протоколу Yandex Speechkit v2. Учитывайте это при разработке или адаптации существующего сервиса.

При создании канала в JAICP и настройке подключения укажите URL сервиса и API-ключ для авторизации вызовов сервиса (при его наличии).

ASR от АСМ Решений​

Чтобы создать подключение ASR от АСМ Решений, вам потребуется получить токен доступа к API. Вы можете обратиться к провайдеру самостоятельно или воспользоваться помощью аккаунт-менеджера Just AI.

После того как вы сохраните подключение, вы сможете выбрать одну из моделей распознавания речи, доступных по вашему токену.