JAICP

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


При создании телефонного канала вы можете подключить собственный аккаунт одного из провайдеров распознавания и синтеза речи. Для этого перейдите на вкладку 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_typepassword.
    • 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 SmartSpeech от Сбера

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

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

Укажите Client ID и Client Secret в настройках подключения ASR при создании канала в JAICP. Нажмите Сохранить.

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

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