Translator in sovereign (national) clouds

The Azure Government cloud is available to US government customers and their partners. US federal, state, local, tribal governments and their partners have access to the Azure Government cloud dedicated instance. Screened US citizens control cloud operations.

Endpoint

Azure portal

Base URL:

https://portal.azure.us

Authorization token

Replace the <region-identifier> parameter with the sovereign cloud identifier:

https://<region-identifier>.api.cognitive.microsoft.us/sts/v1.0/issueToken

Text translation

https://api.cognitive.microsofttranslator.us/

Document Translation custom endpoint

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.us/translator/text/batch/v1.0

Custom Translator portal

https://portal.customtranslator.azure.us/

Example API translation request

Translate a single sentence from English to Simplified Chinese.

Request

curl -X POST "https://api.cognitive.microsofttranslator.us/translate?api-version=3.0?&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <key>" -H "Ocp-Apim-Subscription-Region: chinanorth" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'你好, 你叫什么名字？'}]"

Response body

[
    {
        "translations":[
            {"text": "Hello, what is your name?", "to": "en"}
        ]
    }
]

The Azure operated by 21Vianet cloud is a physical and logical network-isolated instance of cloud services located in China. In order to apply for an Azure operated by 21Vianet account, you need a Chinese legal entity, Internet Content provider (ICP) license, and physical presence within China.

Endpoint

Base URL

Azure portal

https://portal.azure.cn

Authorization token

Replace the <region-identifier> parameter with the sovereign cloud identifier:

https://<region-identifier>.api.cognitive.azure.cn/sts/v1.0/issueToken

Text translation

https://api.translator.azure.cn/translate

Example text translation request

Translate a single sentence from English to Simplified Chinese.

Request

curl -X POST "https://api.translator.azure.cn/translate?api-version=3.0&from=en&to=zh-Hans" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text': 'Hello, what is your name?'}]"

Response body

[
    {
        "translations":[
            {"text": "你好, 你叫什么名字？", "to": "zh-Hans"}
        ]
    }
]

Document Translation custom endpoint

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.cn/translator/text/batch/v1.0

Example batch translation request

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://<storage_acount>.blob.core.chinacloudapi.cn/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://<storage_acount>.blob.core.chinacloudapi.cn/target-zh-Hans?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "zh-Hans"
                }
            ]
        }
    ]
}