Connect your own account

When you create a telephone channel, you can connect your own third-party speech recognition and synthesis account. Click the ASR/TTS tab and select Create connection in the Connection field. Then select your provider and fill out connection settings.

Please note that there’s no need to re-create your connection if you already use ASR/TTS from another provider. Create a connection, e.g. for ASR, then select your connection from the list under TTS.

tip

If you prefer to use your own connection, Just AI ASR/TTS limits do not apply to you.

Google ASR/TTS

You need to create a JWT Token to connect Google ASR/TTS. To do this:

1. Open the Cloud Console and click IAM & Admin in the left panel. Select Service Accounts in the left panel.
2. Click Select a project, select the project and click Open.
3. Find the row for the account you want to create a key for. In this row, click the  icon and select Create key from the dropdown list.
4. Select the key type and click Create. The newly created key will be saved to your computer.

tip

You can also use other methods to create a JWT Token for Google ASR/TTS (learn more here).

Please note that the key format may be different depending on how you create it. Keys created using Cloud Console look as follows:

{
  "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"
}

Now load your key to the connection settings when you create a channel in JAICP and click Save.

Yandex ASR/TTS

You will need to create a service account private key and to copy IDs of your directory, public key and service account to connect Yandex ASR/TTS.

Service account private key

If you do not have a service account yet, create it and assign roles to it.

To create a service account private key:

1. Go to the directory your service account belongs to.
2. Click the Service accounts tab.
3. Select a service account and click the row with its name.
4. Click Create new key in the left pane. Select Create authorized key.
5. Specify the key description to make it easier to find in the control console later.
6. Save the identifier and the private key.

tip

You can also user other methods to create a service account private key for Yandex ASR/TTS (learn more here).

Service account private key format:

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

Service account and public key identifiers

1. Go to the directory your service account belongs to.
2. Click the Service accounts tab.
3. Select a service account and click the row with its name.
4. You can find your service account ID under Overview.
   Service account identifier format: example0mjt06siua65usm.
5. You can find your public key ID under Authorized keys next to the name of the previously created key.
   Public key identifier format: example0mjt06siua65usm.

Directory identifier

1. Open the directory page. You can select the directory in the control console start page. Directories for the cloud selected are usually displayed in this page. You may switch to another cloud if you want.
2. Get the directory identifier from the directory page URL in the control console:
   https://console.cloud.yandex.ru/folders/example1234567 — here, example1234567 is the directory ID.

Now fill out the fields in the connection settings when you create a channel in JAICP and click Save.

Tinkoff ASR

You need to create an authorization token to connect Tinkoff ASR. Learn more about creating an authorization token in the Tinkoff VoiceKit documentation.

Specify API_KEY for API key and SECRET_KEY for Secret key in the connection settings when you create a channel in JAICP. Click Save.

3iTech ASR/TTS

To connect 3iTech ASR/TTS, you will need to obtain an access token via the 3i VOX platform provided by the vendor.

1. Sign up for 3i VOX and confirm your registration.
2. Sign in to the 3i VOX website and go to the API tab.
3. Click Authorize to open a pop-up for managing your API authorizations.
4. Below your account name in the top right corner, click For developers.
5. Copy your client ID and client secret and paste them into Username and Password.
6. Click Authorize to save the credentials. You may now close this pop-up.
7. In the Servers dropdown list, switch the server to /oauth.
8. From the oauth2 section, open the /token method and click Try it out.
9. Set the following data in the request body:
   • grant_type — password.
   • username — your account login.
   • password — your account password.
10. Click Execute to perform the request.

If all went well, the response should contain a JSON which looks like this:

{
  "token_type": "Bearer",
  "access_token": "93CF267BB3034CDA8E2B00409C",
  "scope": "vox"
}

tip

When configuring the connection in JAICP, paste the access_token value into the Token field.

Azure ASR/TTS

To connect Azure ASR/TTS, you will need a Microsoft Azure account.

If you have an enterprise subscription to Microsoft 365, you can also set up access to Azure services via Azure Active Directory, which is included in your subscription for free.

tip

Learn more about Azure integration with Microsoft 365

The whole connection process involves the following steps:

1. Create a new subscription so that Azure resources become available to your account.
2. Azure resources exist within resource groups. Create a new group for your future service.
3. In this group, create a new resource which includes the Speech service.
4. Use the resource key and region to configure the connection in JAICP.

Skip the appropriate steps if you already have a subscription, resource group, or the necessary resource.

Subscription

Sign in to the Azure portal. In order to use Azure services, including the one providing speech recognition and synthesis, your account will need an active subscription.

To create a new subscription:

1. Go to the Subscriptions page.
2. Click Add and select the appropriate subscription offer.
3. Accept the terms of service.
4. Assign a billing account if your subscription is a paid one.

Refer to your directory administrator if you don’t have the permissions to manage subscriptions in your directory.

Resource group

All related Azure resources are created within resource groups.

To create a new resource group:

1. Go to the Resource groups page and click Create.

2. Fill out all fields on the Basics tab:

   • The Subscription which the resource group will be assigned to.

   • The Resource group name.

   • The Region where the resource group infrastructure will be located.

     tip

     The recommended option is to select a region closest to the infrastructure which will utilize the service: this will help reduce network latency. You should also bear in mind the data processing regulations in your local jurisdiction. For installations based in Europe, germanywestcentral is the optimal choice.

3. Fill out the Tags tab if necessary.

4. Click Review + create, then Create. The resource group will be created.

Resource

In the newly created group, create a resource which will incorporate the Speech service.

tip

Speech is a unified service package including speech recognition and synthesis, language identification, speech translation, and other features. Learn more about the Speech service

1. Go to the new resource group and click Create.
2. Find and select Speech in the service marketplace.
3. Fill out all fields on the Basics tab:
   • The Subscription, Resource group, and Region should be the same as for the resource group.
   • The Name of the new resource.
   • The resource Pricing tier (learn more about pricing here).
4. On the Network tab, leave the public access on. Fill out the other tabs if necessary.
5. Click Review + create, then Create. The resource will be created and deployed.

Azure connection settings

Now everything is ready to create and set up the connection.

After creating the resource, click Go to resource and navigate to the Keys and Endpoint tab. Use the data from this page to configure the ASR/TTS connection in JAICP:

• The Resource key can be any of the two available keys.
• The Resource region should match the region where the resource is located.

The fact that there are two keys helps ensure the connection stability. If you need to regenerate one of the keys, use the other key for the connection so that it doesn’t get disrupted.

Kaldi ASR

caution

By default, Kaldi cannot be selected as a provider. Contact your account manager if you want it to become available.

You can deploy your own speech recognition service based on the Kaldi open-source toolkit and connect it to your JAICP projects. JAICP will be compatible with your service implementation if it follows the Yandex Speechkit v2 protocol. Keep this in mind when developing your service or adapting an existing one.

When creating a channel in JAICP and setting up the connection, specify the service URL and the API key for authorizing service calls (if there is one).

ASM Solutions ASR

To connect ASM Solutions ASR, you will need to obtain an API access token. You can contact the vendor by yourself or through your Just AI account manager.

After you save the connection, you will be able to select one of the speech recognition models accessible by your token.