An idiomatic C++ client library for theCloud Text-to-Speech API, a service to synthesize natural-sounding speech by applying powerful neural network models.
While this library isGA, please note Google Cloud C++ client libraries donotfollowSemantic Versioning.
Quickstart
The following shows the code that you'll run in thegoogle/cloud/texttospeech/quickstart/directory, which should give you a taste of the Cloud Text-to-Speech API C++ client library API.
#include "google/cloud/texttospeech/v1/text_to_speech_client.h"
#include <iostream>
auto constexpr kText = R"""(
Four score and seven years ago our fathers brought forth on this
continent, a new nation, conceived in Liberty, and dedicated to
the proposition that all men are created equal.)""";
int main(int argc, char* argv[]) try {
if (argc != 1) {
std::cerr << "Usage: " << argv[0] << "\n";
return 1;
}
namespace texttospeech = ::google::cloud::texttospeech_v1;
auto client = texttospeech::TextToSpeechClient(
texttospeech::MakeTextToSpeechConnection());
google::cloud::texttospeech::v1::SynthesisInput input;
input.set_text(kText);
google::cloud::texttospeech::v1::VoiceSelectionParams voice;
voice.set_language_code("en-US");
google::cloud::texttospeech::v1::AudioConfig audio;
audio.set_audio_encoding(google::cloud::texttospeech::v1::LINEAR16);
auto response = client.SynthesizeSpeech(input, voice, audio);
if (!response) throw std::move(response).status();
// Normally one would play the results (response->audio_content()) over some
// audio device. For this quickstart, we just print some information.
auto constexpr kWavHeaderSize = 48;
auto constexpr kBytesPerSample = 2; // we asked for LINEAR16
auto const sample_count =
(response->audio_content().size() - kWavHeaderSize) / kBytesPerSample;
std::cout << "The audio has " << sample_count << " samples\n";
return 0;
} catch (google::cloud::Status const& status) {
std::cerr << "google::cloud::Status thrown: " << status << "\n";
return 1;
}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis webpage provides documentation for the Cloud Text-to-Speech API C++ client library, which is used for synthesizing natural-sounding speech using neural network models.\u003c/p\u003e\n"],["\u003cp\u003eThe latest release candidate version is 2.37.0-rc, and the page lists a range of past versions from 2.36.0 down to 2.11.0 of this client.\u003c/p\u003e\n"],["\u003cp\u003eThe main class in this library is \u003ccode\u003etexttospeech_v1::TextToSpeechClient\u003c/code\u003e, which exposes all RPCs as member functions.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation includes a quickstart guide demonstrating how to use the library, and other informational sections on error handling, endpoint overrides, and environment variables.\u003c/p\u003e\n"]]],[],null,["Version 2.24.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/texttospeech/latest)\n- [2.41.0](/cpp/docs/reference/texttospeech/2.41.0)\n- [2.40.0](/cpp/docs/reference/texttospeech/2.40.0)\n- [2.39.0](/cpp/docs/reference/texttospeech/2.39.0)\n- [2.38.0](/cpp/docs/reference/texttospeech/2.38.0)\n- [2.37.0](/cpp/docs/reference/texttospeech/2.37.0)\n- [2.36.0](/cpp/docs/reference/texttospeech/2.36.0)\n- [2.35.0](/cpp/docs/reference/texttospeech/2.35.0)\n- [2.34.0](/cpp/docs/reference/texttospeech/2.34.0)\n- [2.33.0](/cpp/docs/reference/texttospeech/2.33.0)\n- [2.32.0](/cpp/docs/reference/texttospeech/2.32.0)\n- [2.31.0](/cpp/docs/reference/texttospeech/2.31.0)\n- [2.30.0](/cpp/docs/reference/texttospeech/2.30.0)\n- [2.29.0](/cpp/docs/reference/texttospeech/2.29.0)\n- [2.28.0](/cpp/docs/reference/texttospeech/2.28.0)\n- [2.27.0](/cpp/docs/reference/texttospeech/2.27.0)\n- [2.26.0](/cpp/docs/reference/texttospeech/2.26.0)\n- [2.25.1](/cpp/docs/reference/texttospeech/2.25.1)\n- [2.24.0](/cpp/docs/reference/texttospeech/2.24.0)\n- [2.23.0](/cpp/docs/reference/texttospeech/2.23.0)\n- [2.22.1](/cpp/docs/reference/texttospeech/2.22.1)\n- [2.21.0](/cpp/docs/reference/texttospeech/2.21.0)\n- [2.20.0](/cpp/docs/reference/texttospeech/2.20.0)\n- [2.19.0](/cpp/docs/reference/texttospeech/2.19.0)\n- [2.18.0](/cpp/docs/reference/texttospeech/2.18.0)\n- [2.17.0](/cpp/docs/reference/texttospeech/2.17.0)\n- [2.16.0](/cpp/docs/reference/texttospeech/2.16.0)\n- [2.15.1](/cpp/docs/reference/texttospeech/2.15.1)\n- [2.14.0](/cpp/docs/reference/texttospeech/2.14.0)\n- [2.13.0](/cpp/docs/reference/texttospeech/2.13.0)\n- [2.12.0](/cpp/docs/reference/texttospeech/2.12.0)\n- [2.11.0](/cpp/docs/reference/texttospeech/2.11.0) \n\nCloud Text-to-Speech API C++ Client Library\n===========================================\n\nAn idiomatic C++ client library for the [Cloud Text-to-Speech API](https://cloud.google.com/text-to-speech), a service to synthesize natural-sounding speech by applying powerful neural network models.\n\nWhile this library is **GA** , please note Google Cloud C++ client libraries do **not** follow [Semantic Versioning](https://semver.org/).\n\n### Quickstart\n\nThe following shows the code that you'll run in the `google/cloud/texttospeech/quickstart/` directory, which should give you a taste of the Cloud Text-to-Speech API C++ client library API. \n\n #include \"google/cloud/texttospeech/v1/text_to_speech_client.h\"\n #include \u003ciostream\u003e\n\n auto constexpr kText = R\"\"\"(\n Four score and seven years ago our fathers brought forth on this\n continent, a new nation, conceived in Liberty, and dedicated to\n the proposition that all men are created equal.)\"\"\";\n\n int main(int argc, char* argv[]) try {\n if (argc != 1) {\n std::cerr \u003c\u003c \"Usage: \" \u003c\u003c argv[0] \u003c\u003c \"\\n\";\n return 1;\n }\n\n namespace texttospeech = ::google::cloud::texttospeech_v1;\n auto client = texttospeech::TextToSpeechClient(\n texttospeech::MakeTextToSpeechConnection());\n\n google::cloud::texttospeech::v1::SynthesisInput input;\n input.set_text(kText);\n google::cloud::texttospeech::v1::VoiceSelectionParams voice;\n voice.set_language_code(\"en-US\");\n google::cloud::texttospeech::v1::AudioConfig audio;\n audio.set_audio_encoding(google::cloud::texttospeech::v1::LINEAR16);\n\n auto response = client.SynthesizeSpeech(input, voice, audio);\n if (!response) throw std::move(response).status();\n // Normally one would play the results (response-\u003eaudio_content()) over some\n // audio device. For this quickstart, we just print some information.\n auto constexpr kWavHeaderSize = 48;\n auto constexpr kBytesPerSample = 2; // we asked for LINEAR16\n auto const sample_count =\n (response-\u003eaudio_content().size() - kWavHeaderSize) / kBytesPerSample;\n std::cout \u003c\u003c \"The audio has \" \u003c\u003c sample_count \u003c\u003c \" samples\\n\";\n\n return 0;\n } catch (google::cloud::Status const& status) {\n std::cerr \u003c\u003c \"google::cloud::Status thrown: \" \u003c\u003c status \u003c\u003c \"\\n\";\n return 1;\n }\n\n### Main classes\n\nThe main class in this library is [`texttospeech_v1::TextToSpeechClient`](/cpp/docs/reference/texttospeech/2.24.0/classgoogle_1_1cloud_1_1texttospeech__v1_1_1TextToSpeechClient). All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock [`texttospeech_v1::TextToSpeechClient`](/cpp/docs/reference/texttospeech/2.24.0/classgoogle_1_1cloud_1_1texttospeech__v1_1_1TextToSpeechClient) when testing your application.\n\n### More Information\n\n- [Error Handling](https://cloud.google.com/cpp/docs/reference/common/latest/common-error-handling.html) - describes how the library reports errors.\n- [How to Override the Default Endpoint](/cpp/docs/reference/texttospeech/2.24.0/texttospeech-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/texttospeech/2.24.0/texttospeech-override-authentication) - describes how to change the authentication credentials used by the library.\n- [Override Retry, Backoff, and Idempotency Policies](/cpp/docs/reference/texttospeech/2.24.0/texttospeech-override-retry) - describes how to change the default retry policies.\n- [Environment Variables](/cpp/docs/reference/texttospeech/2.24.0/texttospeech-env) - describes environment variables that can configure the behavior of the library."]]