Rozhraní REST API pro převod textu na řečText-to-speech REST API

Služba rozpoznávání řeči umožňuje převést text na syntetizované rozpoznávání řeči a získat seznam podporovaných hlasů pro oblast s použitím sady rozhraní REST API.The Speech service allows you to convert text into synthesized speech and get a list of supported voices for a region using a set of REST APIs. Každý dostupný koncový bod je přidružen k oblasti.Each available endpoint is associated with a region. Vyžaduje se klíč předplatného pro koncový bod nebo oblast, kterou plánujete použít.A subscription key for the endpoint/region you plan to use is required.

REST API převodu textu na řeč podporuje neuronové a standardní hlasy převodu textu na řeč, z nichž každý podporuje konkrétní jazyk a dialekt identifikovaný národním prostředím.The text-to-speech REST API supports neural and standard text-to-speech voices, each of which supports a specific language and dialect, identified by locale.

  • Úplný seznam hlasů najdete v tématu Podpora jazyků.For a complete list of voices, see language support.
  • Informace o regionální dostupnosti najdete v tématu oblasti.For information about regional availability, see regions.

Důležité

Náklady se liší pro standardní, vlastní a neuronové hlasy.Costs vary for standard, custom, and neural voices. Další informace najdete v tématu ceny.For more information, see Pricing.

Než začnete používat toto rozhraní API, pochopte:Before using this API, understand:

  • Převod textu na řeč rozhraní REST API vyžaduje také hlavičku ověřování.The text-to-speech REST API requires an Authorization header. To znamená, že je potřeba dokončit výměnu tokenů pro přístup ke službě.This means that you need to complete a token exchange to access the service. Další informace najdete v tématu Ověřování.For more information, see Authentication.

OvěřováníAuthentication

Každá žádost vyžaduje autorizační hlavičku.Each request requires an authorization header. Tato tabulka ukazuje, které hlavičky jsou podporovány pro každou službu:This table illustrates which headers are supported for each service:

Podporované autorizační hlavičkySupported authorization headers Převod řeči na textSpeech-to-text Převod textu na řečText-to-speech
OCP-Apim-Subscription-KeyOcp-Apim-Subscription-Key AnoYes NeNo
udělován NosnýAuthorization: Bearer AnoYes AnoYes

Při použití Ocp-Apim-Subscription-Key záhlaví, je nutné pouze zadejte klíč předplatného.When using the Ocp-Apim-Subscription-Key header, you're only required to provide your subscription key. Příklad:For example:

'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'

Při použití Authorization: Bearer záhlaví, budete muset vytvořit žádost o issueToken koncového bodu.When using the Authorization: Bearer header, you're required to make a request to the issueToken endpoint. V této žádosti o výměnu váš klíč předplatného pro přístupový token, který je platný 10 minut.In this request, you exchange your subscription key for an access token that's valid for 10 minutes. V následujících částech se dozvíte, jak získat token a použít token.In the next few sections you'll learn how to get a token, and use a token.

Jak získat přístupový tokenHow to get an access token

K získání přístupového tokenu, je potřeba vytvořit žádost o issueToken pomocí koncového bodu Ocp-Apim-Subscription-Key a váš klíč předplatného.To get an access token, you'll need to make a request to the issueToken endpoint using the Ocp-Apim-Subscription-Key and your subscription key.

Podporují se tyto oblasti a koncové body:These regions and endpoints are supported:

OblastRegion Koncový bod služby tokenuToken service endpoint
Austrálie – východAustralia East https://australiaeast.api.cognitive.microsoft.com/sts/v1.0/issueToken
Kanada – středCanada Central https://canadacentral.api.cognitive.microsoft.com/sts/v1.0/issueToken
Střední USACentral US https://centralus.api.cognitive.microsoft.com/sts/v1.0/issueToken
Východní AsieEast Asia https://eastasia.api.cognitive.microsoft.com/sts/v1.0/issueToken
USA – východEast US https://eastus.api.cognitive.microsoft.com/sts/v1.0/issueToken
Východní USA 2East US 2 https://eastus2.api.cognitive.microsoft.com/sts/v1.0/issueToken
Francie – středFrance Central https://francecentral.api.cognitive.microsoft.com/sts/v1.0/issueToken
Indie – středIndia Central https://centralindia.api.cognitive.microsoft.com/sts/v1.0/issueToken
Japonsko – východJapan East https://japaneast.api.cognitive.microsoft.com/sts/v1.0/issueToken
Korea – středKorea Central https://koreacentral.api.cognitive.microsoft.com/sts/v1.0/issueToken
Středoseverní USANorth Central US https://northcentralus.api.cognitive.microsoft.com/sts/v1.0/issueToken
Severní EvropaNorth Europe https://northeurope.api.cognitive.microsoft.com/sts/v1.0/issueToken
Středojižní USASouth Central US https://southcentralus.api.cognitive.microsoft.com/sts/v1.0/issueToken
Jihovýchodní AsieSoutheast Asia https://southeastasia.api.cognitive.microsoft.com/sts/v1.0/issueToken
Velká Británie – jihUK South https://uksouth.api.cognitive.microsoft.com/sts/v1.0/issueToken
Západní EvropaWest Europe https://westeurope.api.cognitive.microsoft.com/sts/v1.0/issueToken
Západní USAWest US https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken
Západní USA 2West US 2 https://westus2.api.cognitive.microsoft.com/sts/v1.0/issueToken

Tyto ukázky použijte při vytváření žádosti o token přístupu.Use these samples to create your access token request.

Ukázka protokolu HTTPHTTP sample

V tomto příkladu je jednoduché požadavku HTTP k získání tokenu.This example is a simple HTTP request to get a token. Nahraďte YOUR_SUBSCRIPTION_KEY s klíči předplatného Speech Service.Replace YOUR_SUBSCRIPTION_KEY with your Speech Service subscription key. Pokud vaše předplatné není v oblasti USA – Západ, nahraďte Host záhlaví s názvem hostitele vaší oblasti.If your subscription isn't in the West US region, replace the Host header with your region's host name.

POST /sts/v1.0/issueToken HTTP/1.1
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
Host: westus.api.cognitive.microsoft.com
Content-type: application/x-www-form-urlencoded
Content-Length: 0

Tělo odpovědi obsahuje přístupový token ve formátu JSON Web Token (JWT).The body of the response contains the access token in JSON Web Token (JWT) format.

Ukázka PowerShelluPowerShell sample

V tomto příkladu je jednoduchý skript prostředí PowerShell k získání přístupového tokenu.This example is a simple PowerShell script to get an access token. Nahraďte YOUR_SUBSCRIPTION_KEY s klíči předplatného Speech Service.Replace YOUR_SUBSCRIPTION_KEY with your Speech Service subscription key. Nezapomeňte použít správný koncový bod pro oblast, která odpovídá vašeho předplatného.Make sure to use the correct endpoint for the region that matches your subscription. V tomto příkladu je aktuálně nastavený na západní USA.This example is currently set to West US.

$FetchTokenHeader = @{
  'Content-type'='application/x-www-form-urlencoded';
  'Content-Length'= '0';
  'Ocp-Apim-Subscription-Key' = 'YOUR_SUBSCRIPTION_KEY'
}

$OAuthToken = Invoke-RestMethod -Method POST -Uri https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken
 -Headers $FetchTokenHeader

# show the token received
$OAuthToken

Ukázka cURLcURL sample

cURL je nástroj příkazového řádku jsou k dispozici v systému Linux (a v subsystému Windows pro Linux).cURL is a command-line tool available in Linux (and in the Windows Subsystem for Linux). Tento příkaz cURL znázorňuje, jak získat přístupový token.This cURL command illustrates how to get an access token. Nahraďte YOUR_SUBSCRIPTION_KEY s klíči předplatného Speech Service.Replace YOUR_SUBSCRIPTION_KEY with your Speech Service subscription key. Nezapomeňte použít správný koncový bod pro oblast, která odpovídá vašeho předplatného.Make sure to use the correct endpoint for the region that matches your subscription. V tomto příkladu je aktuálně nastavený na západní USA.This example is currently set to West US.

curl -v -X POST
 "https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken" \
 -H "Content-type: application/x-www-form-urlencoded" \
 -H "Content-Length: 0" \
 -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY"

Ukázka v jazyce C#C# sample

To C# třídy ukazuje, jak získat přístupový token.This C# class illustrates how to get an access token. Předejte klíč předplatného Speech Service při vytváření instance třídy.Pass your Speech Service subscription key when you instantiate the class. Pokud vaše předplatné není v oblasti USA – Západ, změňte hodnotu vlastnosti FetchTokenUri tak, aby odpovídaly oblast pro vaše předplatné.If your subscription isn't in the West US region, change the value of FetchTokenUri to match the region for your subscription.

public class Authentication
{
    public static readonly string FetchTokenUri =
        "https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken";
    private string subscriptionKey;
    private string token;

    public Authentication(string subscriptionKey)
    {
        this.subscriptionKey = subscriptionKey;
        this.token = FetchTokenAsync(FetchTokenUri, subscriptionKey).Result;
    }

    public string GetAccessToken()
    {
        return this.token;
    }

    private async Task<string> FetchTokenAsync(string fetchUri, string subscriptionKey)
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", subscriptionKey);
            UriBuilder uriBuilder = new UriBuilder(fetchUri);

            var result = await client.PostAsync(uriBuilder.Uri.AbsoluteUri, null);
            Console.WriteLine("Token Uri: {0}", uriBuilder.Uri.AbsoluteUri);
            return await result.Content.ReadAsStringAsync();
        }
    }
}

Ukázka PythonuPython sample

# Request module must be installed.
# Run pip install requests if necessary.
import requests

subscription_key = 'REPLACE_WITH_YOUR_KEY'


def get_token(subscription_key):
    fetch_token_url = 'https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken'
    headers = {
        'Ocp-Apim-Subscription-Key': subscription_key
    }
    response = requests.post(fetch_token_url, headers=headers)
    access_token = str(response.text)
    print(access_token)

Použití přístupového tokenuHow to use an access token

Přístupový token odesílaných do služby, jako Authorization: Bearer <TOKEN> záhlaví.The access token should be sent to the service as the Authorization: Bearer <TOKEN> header. Každý přístupový token je platný 10 minut.Each access token is valid for 10 minutes. Kdykoli můžete získat nový token, ale pokud chcete minimalizovat síťový provoz a latence, doporučujeme použít stejný token devět minut.You can get a new token at any time, however, to minimize network traffic and latency, we recommend using the same token for nine minutes.

Tady je ukázka požadavku HTTP pro převod textu na řeč rozhraní REST API:Here's a sample HTTP request to the text-to-speech REST API:

POST /cognitiveservices/v1 HTTP/1.1
Authorization: Bearer YOUR_ACCESS_TOKEN
Host: westus.stt.speech.microsoft.com
Content-type: application/ssml+xml
Content-Length: 199
Connection: Keep-Alive

// Message body here...

Získat seznam hlasůGet a list of voices

Koncový bod voices/list umožňuje získat úplný seznam hlasů pro konkrétní oblast nebo koncový bod.The voices/list endpoint allows you to get a full list of voices for a specific region/endpoint.

Oblasti a koncových bodůRegions and endpoints

OblastRegion Koncový bodEndpoint
Austrálie – východAustralia East https://australiaeast.tts.speech.microsoft.com/cognitiveservices/voices/list
Brazílie – jihBrazil South https://brazilsouth.tts.speech.microsoft.com/cognitiveservices/voices/list
Kanada – středCanada Central https://canadacentral.tts.speech.microsoft.com/cognitiveservices/voices/list
Střední USACentral US https://centralus.tts.speech.microsoft.com/cognitiveservices/voices/list
Východní AsieEast Asia https://eastasia.tts.speech.microsoft.com/cognitiveservices/voices/list
USA – východEast US https://eastus.tts.speech.microsoft.com/cognitiveservices/voices/list
Východ USA 2East US 2 https://eastus2.tts.speech.microsoft.com/cognitiveservices/voices/list
Francie – středFrance Central https://francecentral.tts.speech.microsoft.com/cognitiveservices/voices/list
Indie – středIndia Central https://centralindia.tts.speech.microsoft.com/cognitiveservices/voices/list
Japonsko – východJapan East https://japaneast.tts.speech.microsoft.com/cognitiveservices/voices/list
Korea – středKorea Central https://koreacentral.tts.speech.microsoft.com/cognitiveservices/voices/list
Středoseverní USANorth Central US https://northcentralus.tts.speech.microsoft.com/cognitiveservices/voices/list
Severní EvropaNorth Europe https://northeurope.tts.speech.microsoft.com/cognitiveservices/voices/list
Středojižní USASouth Central US https://southcentralus.tts.speech.microsoft.com/cognitiveservices/voices/list
Jihovýchodní AsieSoutheast Asia https://southeastasia.tts.speech.microsoft.com/cognitiveservices/voices/list
Velká Británie – jihUK South https://uksouth.tts.speech.microsoft.com/cognitiveservices/voices/list
Západní EvropaWest Europe https://westeurope.tts.speech.microsoft.com/cognitiveservices/voices/list
Západní USAWest US https://westus.tts.speech.microsoft.com/cognitiveservices/voices/list
Západní USA 2West US 2 https://westus2.tts.speech.microsoft.com/cognitiveservices/voices/list

Hlavičky požadavkuRequest headers

Tato tabulka obsahuje seznam požadovaných a volitelných hlaviček pro požadavky na převod textu na řeč.This table lists required and optional headers for text-to-speech requests.

HlavičkaHeader PopisDescription Povinné / volitelnéRequired / Optional
Authorization Autorizační token předcházet slovo Bearer.An authorization token preceded by the word Bearer. Další informace najdete v tématu Ověřování.For more information, see Authentication. Požaduje seRequired

Text požadavkuRequest body

Pro GET požadavků na tento koncový bod není tělo vyžadováno.A body isn't required for GET requests to this endpoint.

Ukázková žádostSample request

Tato žádost vyžaduje pouze hlavičku autorizace.This request only requires an authorization header.

GET /cognitiveservices/voices/list HTTP/1.1

Host: westus.tts.speech.microsoft.com
Authorization: Bearer [Base64 access_token]

Ukázková odpověďSample response

Tato odpověď byla zkrácena, aby ukázala strukturu odpovědi.This response has been truncated to illustrate the structure of a response.

Poznámka

Dostupnost hlasu se liší podle oblasti nebo koncového bodu.Voice availability varies by region/endpoint.

[
    {
        "Name": "Microsoft Server Speech Text to Speech Voice (ar-EG, Hoda)",
        "ShortName": "ar-EG-Hoda",
        "Gender": "Female",
        "Locale": "ar-EG"
    },
    {
        "Name": "Microsoft Server Speech Text to Speech Voice (ar-SA, Naayf)",
        "ShortName": "ar-SA-Naayf",
        "Gender": "Male",
        "Locale": "ar-SA"
    },
    {
        "Name": "Microsoft Server Speech Text to Speech Voice (bg-BG, Ivan)",
        "ShortName": "bg-BG-Ivan",
        "Gender": "Male",
        "Locale": "bg-BG"
    },
    {
        "Name": "Microsoft Server Speech Text to Speech Voice (ca-ES, HerenaRUS)",
        "ShortName": "ca-ES-HerenaRUS",
        "Gender": "Female",
        "Locale": "ca-ES"
    },
    {
        "Name": "Microsoft Server Speech Text to Speech Voice (cs-CZ, Jakub)",
        "ShortName": "cs-CZ-Jakub",
        "Gender": "Male",
        "Locale": "cs-CZ"
    },

    ...

]

Stavové kódy HTTPHTTP status codes

Stavový kód HTTP pro každou odpověď indikuje úspěch nebo běžné chyby.The HTTP status code for each response indicates success or common errors.

Stavový kód HTTPHTTP status code PopisDescription Možný důvodPossible reason
200200 OKOK Požadavek byl úspěšný.The request was successful.
400400 Nesprávná žádostBad Request Povinný parametr nebyl nalezen, prázdný nebo null.A required parameter is missing, empty, or null. Nebo hodnota předaná buď povinný nebo volitelný parametr není platný.Or, the value passed to either a required or optional parameter is invalid. Běžné potíže se hlavičku, která je příliš dlouhý.A common issue is a header that is too long.
401401 NeautorizovánoUnauthorized Požadavek není autorizovaný.The request is not authorized. Ověřte váš klíč předplatného nebo token je platný a v oblasti správné.Check to make sure your subscription key or token is valid and in the correct region.
429429 Příliš mnoho žádostíToo Many Requests Překročili jste kvótu nebo počet požadavků pro vaše předplatné povolená.You have exceeded the quota or rate of requests allowed for your subscription.
502502 Chybná bránaBad Gateway Problém sítě nebo na straně serveru.Network or server-side issue. Může také znamenat neplatné záhlaví.May also indicate invalid headers.

Převod textu na řečConvert text-to-speech

v1 koncový bod umožňuje převod textu na řeč pomocí jazyka SSML (Speech Shrnutí značek).The v1 endpoint allows you to convert text-to-speech using Speech Synthesis Markup Language (SSML).

Oblasti a koncových bodůRegions and endpoints

Tyto oblasti jsou podporovány pro převod textu na řeč pomocí rozhraní REST API.These regions are supported for text-to-speech using the REST API. Ujistěte se, že vyberete koncového bodu, který odpovídá oblasti vašeho předplatného.Make sure that you select the endpoint that matches your subscription region.

Standardní a neuronových sítí hlasůStandard and neural voices

Tato tabulka slouží k určování dostupnosti standardní a neuronových sítí hlasy oblasti nebo koncového bodu:Use this table to determine availability of standard and neural voices by region/endpoint:

OblastRegion Koncový bodEndpoint Standard VoicesStandard Voices Neural VoicesNeural Voices
Austrálie – východAustralia East https://australiaeast.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Kanada – středCanada Central https://canadacentral.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Střední USACentral US https://centralus.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Východní AsieEast Asia https://eastasia.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
USA – východEast US https://eastus.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Východní USA 2East US 2 https://eastus2.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Francie – středFrance Central https://francecentral.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Indie – středIndia Central https://centralindia.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Japonsko – východJapan East https://japaneast.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Korea – středKorea Central https://koreacentral.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Středoseverní USANorth Central US https://northcentralus.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Severní EvropaNorth Europe https://northeurope.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Středojižní USASouth Central US https://southcentralus.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Jihovýchodní AsieSoutheast Asia https://southeastasia.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Velká Británie – jihUK South https://uksouth.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Západní EvropaWest Europe https://westeurope.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes
Západní USAWest US https://westus.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes NeNo
Západní USA 2West US 2 https://westus2.tts.speech.microsoft.com/cognitiveservices/v1 AnoYes AnoYes

Vlastní hlasůCustom voices

Pokud jste vytvořili vlastní hlasové písmo, použijte koncového bodu, který jste vytvořili.If you've created a custom voice font, use the endpoint that you've created. Můžete také použít koncových bodů uvedených níže, nahradí {deploymentId} s ID nasazení pro váš model hlasu.You can also use the endpoints listed below, replacing the {deploymentId} with the deployment ID for your voice model.

OblastRegion Koncový bodEndpoint
Austrálie – východAustralia East https://australiaeast.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Kanada – středCanada Central https://canadacentral.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Střední USACentral US https://centralus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Východní AsieEast Asia https://eastasia.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
USA – východEast US https://eastus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Východní USA 2East US 2 https://eastus2.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Francie – středFrance Central https://francecentral.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Indie – středIndia Central https://centralindia.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Japonsko – východJapan East https://japaneast.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Korea – středKorea Central https://koreacentral.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Středoseverní USANorth Central US https://northcentralus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Severní EvropaNorth Europe https://northeurope.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Středojižní USASouth Central US https://southcentralus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Jihovýchodní AsieSoutheast Asia https://southeastasia.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Velká Británie – jihUK South https://uksouth.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Západní EvropaWest Europe https://westeurope.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Západní USAWest US https://westus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}
Západní USA 2West US 2 https://westus2.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}

Hlavičky požadavkuRequest headers

Tato tabulka obsahuje seznam požadovaných a volitelných hlaviček pro požadavky na převod textu na řeč.This table lists required and optional headers for text-to-speech requests.

HlavičkaHeader PopisDescription Povinné / volitelnéRequired / Optional
Authorization Autorizační token předcházet slovo Bearer.An authorization token preceded by the word Bearer. Další informace najdete v tématu Ověřování.For more information, see Authentication. Požaduje seRequired
Content-Type Určuje typ obsahu pro zadaný text.Specifies the content type for the provided text. Přijata hodnota: application/ssml+xml.Accepted value: application/ssml+xml. Požaduje seRequired
X-Microsoft-OutputFormat Určuje formát zvukového výstupu.Specifies the audio output format. Úplný seznam platných hodnot najdete v tématu zvuku výstupy.For a complete list of accepted values, see audio outputs. Požaduje seRequired
User-Agent Název aplikace.The application name. Zadaná hodnota musí být kratší než 255 znaků.The value provided must be less than 255 characters. Požaduje seRequired

Zvukový výstupyAudio outputs

Toto je seznam podporovaných formátů zvuku, které se odesílají v každé žádosti o jako X-Microsoft-OutputFormat záhlaví.This is a list of supported audio formats that are sent in each request as the X-Microsoft-OutputFormat header. Každý zahrnuje s přenosovou rychlostí a typ kódování.Each incorporates a bitrate and encoding type. Služba Speech podporuje zvukové výstupy 24 kHz, 16 kHz a 8 kHz.The Speech service supports 24 kHz, 16 kHz, and 8 kHz audio outputs.

raw-16khz-16bit-mono-pcm raw-8khz-8bit-mono-mulaw
riff-8khz-8bit-mono-alaw riff-8khz-8bit-mono-mulaw
riff-16khz-16bit-mono-pcm audio-16khz-128kbitrate-mono-mp3
audio-16khz-64kbitrate-mono-mp3 audio-16khz-32kbitrate-mono-mp3
raw-24khz-16bit-mono-pcm riff-24khz-16bit-mono-pcm
audio-24khz-160kbitrate-mono-mp3 audio-24khz-96kbitrate-mono-mp3
audio-24khz-48kbitrate-mono-mp3

Poznámka

Pokud vybraný hlasový a výstupní formát různé přenosové rychlosti, zvuku poklesu podle potřeby.If your selected voice and output format have different bit rates, the audio is resampled as necessary. Nicméně na 24 kHz hlasy nepodporují audio-16khz-16kbps-mono-siren a riff-16khz-16kbps-mono-siren výstupní formáty.However, 24 kHz voices do not support audio-16khz-16kbps-mono-siren and riff-16khz-16kbps-mono-siren output formats.

Text požadavkuRequest body

Tělo každé žádosti o POST se odešle jako jazyk SSML (Speech syntézy).The body of each POST request is sent as Speech Synthesis Markup Language (SSML). SSML umožňuje zvolit hlas a jazyk syntetizované řeči, kterou vrátí služba pro převod textu na mluvené slovo.SSML allows you to choose the voice and language of the synthesized speech returned by the text-to-speech service. Úplný seznam podporovaných hlasů najdete v tématu Podpora jazyků.For a complete list of supported voices, see language support.

Poznámka

Pokud používáte vlastní hlas, text požadavku se dá poslat jako prostý text (ASCII nebo UTF-8).If using a custom voice, the body of a request can be sent as plain text (ASCII or UTF-8).

Ukázková žádostSample request

Tento požadavek HTTP používá k určení hlasu SSML.This HTTP request uses SSML to specify the voice and language. Text může mít maximálně 1 000 znaků.The body cannot exceed 1,000 characters.

POST /cognitiveservices/v1 HTTP/1.1

X-Microsoft-OutputFormat: raw-16khz-16bit-mono-pcm
Content-Type: application/ssml+xml
Host: westus.tts.speech.microsoft.com
Content-Length: 225
Authorization: Bearer [Base64 access_token]

<speak version='1.0' xml:lang='en-US'><voice xml:lang='en-US' xml:gender='Female'
    name='en-US-JessaRUS'>
        Microsoft Speech Service Text-to-Speech API
</voice></speak>

Příklady konkrétního jazyka najdete v našich rychlých startech:See our quickstarts for language-specific examples:

Stavové kódy HTTPHTTP status codes

Stavový kód HTTP pro každou odpověď indikuje úspěch nebo běžné chyby.The HTTP status code for each response indicates success or common errors.

Stavový kód HTTPHTTP status code PopisDescription Možný důvodPossible reason
200200 OKOK Žádost byla úspěšná. text odpovědi je zvukový soubor.The request was successful; the response body is an audio file.
400400 Nesprávná žádostBad Request Povinný parametr nebyl nalezen, prázdný nebo null.A required parameter is missing, empty, or null. Nebo hodnota předaná buď povinný nebo volitelný parametr není platný.Or, the value passed to either a required or optional parameter is invalid. Běžné potíže se hlavičku, která je příliš dlouhý.A common issue is a header that is too long.
401401 NeautorizovánoUnauthorized Požadavek není autorizovaný.The request is not authorized. Ověřte váš klíč předplatného nebo token je platný a v oblasti správné.Check to make sure your subscription key or token is valid and in the correct region.
413413 Příliš velká entita požadavkuRequest Entity Too Large Vstup SSML je delší než 1024 znaků.The SSML input is longer than 1024 characters.
415415 Nepodporovaný typ médiaUnsupported Media Type Je možné, že byl zadán nesprávný Content-Type.It's possible that the wrong Content-Type was provided. Content-Type by měly být nastavené na application/ssml+xml.Content-Type should be set to application/ssml+xml.
429429 Příliš mnoho žádostíToo Many Requests Překročili jste kvótu nebo počet požadavků pro vaše předplatné povolená.You have exceeded the quota or rate of requests allowed for your subscription.
502502 Chybná bránaBad Gateway Problém sítě nebo na straně serveru.Network or server-side issue. Může také znamenat neplatné záhlaví.May also indicate invalid headers.

Pokud je stav protokolu HTTP 200 OK, tělo odpovědi obsahuje zvukový soubor v požadovanému formátu.If the HTTP status is 200 OK, the body of the response contains an audio file in the requested format. Tento soubor můžete přehrát má přenést, uložit do vyrovnávací paměti, nebo uložit do souboru.This file can be played as it's transferred, saved to a buffer, or saved to a file.

Další krokyNext steps