Speech Services in sovereign clouds

Azure Government (United States)

Available to US government entities and their partners only. See more information about Azure Government here and here.

• Azure portal:
  • https://portal.azure.us/
• Regions:
  • US Gov Arizona
  • US Gov Virginia
• Available pricing tiers:
  • Free (F0) and Standard (S0). See more details here
• Supported features:
  • Speech-to-text
    • Custom speech (Acoustic Model (AM) and Language Model (LM) adaptation)
      • Speech Studio
  • Text-to-speech
    • Standard voice
    • Neural voice
  • Speech translator
• Unsupported features:
  • Custom Voice
• Supported languages:
  • See the list of supported languages here

Endpoint information

This section contains Speech Services endpoint information for the usage with Speech SDK, Speech-to-text REST API, and Text-to-speech REST API.

Speech Services REST API

Speech Services REST API endpoints in Azure Government have the following format:

REST API type / operation	Endpoint format
Access token	https://<REGION_IDENTIFIER>.api.cognitive.microsoft.us/sts/v1.0/issueToken
Speech-to-text REST API v3.0	https://<REGION_IDENTIFIER>.api.cognitive.microsoft.us/<URL_PATH>
Speech-to-text REST API for short audio	https://<REGION_IDENTIFIER>.stt.speech.azure.us/<URL_PATH>
Text-to-speech REST API	https://<REGION_IDENTIFIER>.tts.speech.azure.us/<URL_PATH>

Replace <REGION_IDENTIFIER> with the identifier matching the region of your subscription from this table:

	Region identifier
US Gov Arizona	usgovarizona
US Gov Virginia	usgovvirginia

Speech SDK

For Speech SDK in sovereign clouds you need to use "from host / with host" instantiation of SpeechConfig class or --host option of Speech CLI. (You may also use "from endpoint / with endpoint" instantiation and --endpoint Speech CLI option).

SpeechConfig class should be instantiated like this:

C#

var config = SpeechConfig.FromHost(usGovHost, subscriptionKey);

C++

auto config = SpeechConfig::FromHost(usGovHost, subscriptionKey);

Java

SpeechConfig config = SpeechConfig.fromHost(usGovHost, subscriptionKey);

Python

import azure.cognitiveservices.speech as speechsdk
speech_config = speechsdk.SpeechConfig(host=usGovHost, subscription=subscriptionKey)

Objective-C

SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithHost:usGovHost subscription:subscriptionKey];

Speech CLI should be used like this (note the --host option):

spx recognize --host "usGovHost" --file myaudio.wav

Replace subscriptionKey with your Speech resource key. Replace usGovHost with the expression matching the required service offering and the region of your subscription from this table:

Region / Service offering	Host expression
US Gov Arizona
Speech-to-text	wss://usgovarizona.stt.speech.azure.us
Text-to-Speech	https://usgovarizona.tts.speech.azure.us
US Gov Virginia
Speech-to-text	wss://usgovvirginia.stt.speech.azure.us
Text-to-Speech	https://usgovvirginia.tts.speech.azure.us

Azure China

Available to organizations with a business presence in China. See more information about Azure China here.

• Azure portal:
  • https://portal.azure.cn/
• Regions:
  • China East 2
  • China North 2
• Available pricing tiers:
  • Free (F0) and Standard (S0). See more details here
• Supported features:
  • Speech-to-text
    • Custom speech (Acoustic Model (AM) and Language Model (LM) adaptation)
      • Speech Studio
    • Pronunciation assessment
  • Text-to-speech
    • Standard voice
    • Neural voice
  • Speech translator
• Unsupported features:
  • Custom Voice
• Supported languages:
  • See the list of supported languages here

Endpoint information

This section contains Speech Services endpoint information for the usage with Speech SDK, Speech-to-text REST API, and Text-to-speech REST API.

Speech Services REST API

Speech Services REST API endpoints in Azure China have the following format:

REST API type / operation	Endpoint format
Access token	https://<REGION_IDENTIFIER>.api.cognitive.azure.cn/sts/v1.0/issueToken
Speech-to-text REST API v3.0	https://<REGION_IDENTIFIER>.api.cognitive.azure.cn/<URL_PATH>
Speech-to-text REST API for short audio	https://<REGION_IDENTIFIER>.stt.speech.azure.cn/<URL_PATH>
Text-to-speech REST API	https://<REGION_IDENTIFIER>.tts.speech.azure.cn/<URL_PATH>

Replace <REGION_IDENTIFIER> with the identifier matching the region of your subscription from this table:

	Region identifier
China East 2	chinaeast2
China North 2	chinanorth2

Speech SDK

For Speech SDK in sovereign clouds you need to use "from host / with host" instantiation of SpeechConfig class or --host option of Speech CLI. (You may also use "from endpoint / with endpoint" instantiation and --endpoint Speech CLI option).

SpeechConfig class should be instantiated like this:

C#

var config = SpeechConfig.FromHost(azCnHost, subscriptionKey);

C++

auto config = SpeechConfig::FromHost(azCnHost, subscriptionKey);

Java

SpeechConfig config = SpeechConfig.fromHost(azCnHost, subscriptionKey);

Python

import azure.cognitiveservices.speech as speechsdk
speech_config = speechsdk.SpeechConfig(host=azCnHost, subscription=subscriptionKey)

Objective-C

SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithHost:azCnHost subscription:subscriptionKey];

Speech CLI should be used like this (note the --host option):

spx recognize --host "azCnHost" --file myaudio.wav

Replace subscriptionKey with your Speech resource key. Replace azCnHost with the expression matching the required service offering and the region of your subscription from this table:

Region / Service offering	Host expression
China East 2
Speech-to-text	wss://chinaeast2.stt.speech.azure.cn
Text-to-Speech	https://chinaeast2.tts.speech.azure.cn
China North 2
Speech-to-text	wss://chinanorth2.stt.speech.azure.cn
Text-to-Speech	https://chinanorth2.tts.speech.azure.cn