feat: [google-cloud-texttospeech] Support promptable voices M4A AudioEncoding; doc fixes. (googleapis#14292)

- [ ] Regenerate this pull request now.


BEGIN_COMMIT_OVERRIDE

feat: Support promptable voices by specifying a model name and a prompt
feat: Add enum value M4A to enum AudioEncoding
docs: A comment for enum value `AUDIO_ENCODING_UNSPECIFIED` in enum
`AudioEncoding` is changed
feat: [google-cloud-texttospeech] Support promptable voices by
specifying a model name and a prompt
docs: A comment for method `StreamingSynthesize` in service
`TextToSpeech` is changed
docs: A comment for enum value `OGG_OPUS` in enum `AudioEncoding` is
changed
docs: A comment for enum value `PCM` in enum `AudioEncoding` is changed
docs: A comment for field `low_latency_journey_synthesis` in message
`.google.cloud.texttospeech.v1beta1.AdvancedVoiceOptions` is changed
docs: A comment for enum value `PHONETIC_ENCODING_IPA` in enum
`PhoneticEncoding` is changed
docs: A comment for enum value `PHONETIC_ENCODING_X_SAMPA` in enum
`PhoneticEncoding` is changed
docs: A comment for field `phrase` in message
`.google.cloud.texttospeech.v1beta1.CustomPronunciationParams` is
changed
docs: A comment for field `pronunciations` in message
`.google.cloud.texttospeech.v1beta1.CustomPronunciations` is changed
docs: A comment for message `MultiSpeakerMarkup` is changed
docs: A comment for field `custom_pronunciations` in message
`.google.cloud.texttospeech.v1beta1.SynthesisInput` is changed
docs: A comment for field `voice_clone` in message
`.google.cloud.texttospeech.v1beta1.VoiceSelectionParams` is changed
docs: A comment for field `speaking_rate` in message
`.google.cloud.texttospeech.v1beta1.AudioConfig` is changed
docs: A comment for field `audio_encoding` in message
`.google.cloud.texttospeech.v1beta1.StreamingAudioConfig` is changed
docs: A comment for field `text` in message
`.google.cloud.texttospeech.v1beta1.StreamingSynthesisInput` is changed

END_COMMIT_OVERRIDE

feat: Add enum value M4A to enum AudioEncoding
docs: A comment for enum value `AUDIO_ENCODING_UNSPECIFIED` in enum
`AudioEncoding` is changed

PiperOrigin-RevId: 799573824

Source-Link:
googleapis/googleapis@a92cee3

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/d182858feeaba9d167f784aaf301f395d1d288b4
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRleHR0b3NwZWVjaC8uT3dsQm90LnlhbWwiLCJoIjoiZDE4Mjg1OGZlZWFiYTlkMTY3Zjc4NGFhZjMwMWYzOTVkMWQyODhiNCJ9

BEGIN_NESTED_COMMIT
feat: [google-cloud-texttospeech] Support promptable voices by
specifying a model name and a prompt
feat: Add enum value M4A to enum AudioEncoding
docs: A comment for method `StreamingSynthesize` in service
`TextToSpeech` is changed
docs: A comment for enum value `AUDIO_ENCODING_UNSPECIFIED` in enum
`AudioEncoding` is changed
docs: A comment for enum value `OGG_OPUS` in enum `AudioEncoding` is
changed
docs: A comment for enum value `PCM` in enum `AudioEncoding` is changed
docs: A comment for field `low_latency_journey_synthesis` in message
`.google.cloud.texttospeech.v1beta1.AdvancedVoiceOptions` is changed
docs: A comment for enum value `PHONETIC_ENCODING_IPA` in enum
`PhoneticEncoding` is changed
docs: A comment for enum value `PHONETIC_ENCODING_X_SAMPA` in enum
`PhoneticEncoding` is changed
docs: A comment for field `phrase` in message
`.google.cloud.texttospeech.v1beta1.CustomPronunciationParams` is
changed
docs: A comment for field `pronunciations` in message
`.google.cloud.texttospeech.v1beta1.CustomPronunciations` is changed
docs: A comment for message `MultiSpeakerMarkup` is changed
docs: A comment for field `custom_pronunciations` in message
`.google.cloud.texttospeech.v1beta1.SynthesisInput` is changed
docs: A comment for field `voice_clone` in message
`.google.cloud.texttospeech.v1beta1.VoiceSelectionParams` is changed
docs: A comment for field `speaking_rate` in message
`.google.cloud.texttospeech.v1beta1.AudioConfig` is changed
docs: A comment for field `audio_encoding` in message
`.google.cloud.texttospeech.v1beta1.StreamingAudioConfig` is changed
docs: A comment for field `text` in message
`.google.cloud.texttospeech.v1beta1.StreamingSynthesisInput` is changed

PiperOrigin-RevId: 799242210

Source-Link:
googleapis/googleapis@b738e78

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/45f4f522fd302bbbfe6fe2f0d08a26f020e90e19
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXRleHR0b3NwZWVjaC8uT3dsQm90LnlhbWwiLCJoIjoiNDVmNGY1MjJmZDMwMmJiYmZlNmZlMmYwZDA4YTI2ZjAyMGU5MGUxOSJ9
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Victor Chudnovsky <vchudnov@google.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-texttospeech/google/cloud/texttospeech/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.27.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.27.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/async_client.py

@@ -438,7 +438,7 @@ async def sample_synthesize_speech():
                 voice.language_code = "language_code_value"
 
                 audio_config = texttospeech_v1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 request = texttospeech_v1.SynthesizeSpeechRequest(
                     input=input,

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech/client.py

@@ -856,7 +856,7 @@ def sample_synthesize_speech():
                 voice.language_code = "language_code_value"
 
                 audio_config = texttospeech_v1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 request = texttospeech_v1.SynthesizeSpeechRequest(
                     input=input,

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech_long_audio_synthesize/async_client.py

@@ -340,7 +340,7 @@ async def sample_synthesize_long_audio():
                 input.text = "text_value"
 
                 audio_config = texttospeech_v1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 voice = texttospeech_v1.VoiceSelectionParams()
                 voice.language_code = "language_code_value"

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/services/text_to_speech_long_audio_synthesize/client.py

@@ -768,7 +768,7 @@ def sample_synthesize_long_audio():
                 input.text = "text_value"
 
                 audio_config = texttospeech_v1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 voice = texttospeech_v1.VoiceSelectionParams()
                 voice.language_code = "language_code_value"

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1/types/cloud_tts.py

@@ -81,7 +81,8 @@ class AudioEncoding(proto.Enum):
 
     Values:
         AUDIO_ENCODING_UNSPECIFIED (0):
-            Not specified. Will return result
+            Not specified. Only used by GenerateVoiceCloningKey.
+            Otherwise, will return result
             [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
         LINEAR16 (1):
             Uncompressed 16-bit signed little-endian
@@ -109,6 +110,8 @@ class AudioEncoding(proto.Enum):
             samples (Linear PCM). Note that as opposed to
             LINEAR16, audio won't be wrapped in a WAV (or
             any other) header.
+        M4A (8):
+            M4A audio.
     """
     AUDIO_ENCODING_UNSPECIFIED = 0
     LINEAR16 = 1
@@ -117,6 +120,7 @@ class AudioEncoding(proto.Enum):
     MULAW = 5
     ALAW = 6
     PCM = 7
+    M4A = 8
 
 
 class ListVoicesRequest(proto.Message):
@@ -520,6 +524,10 @@ class VoiceSelectionParams(proto.Message):
             [VoiceCloneParams.voice_clone_key] is set, the service
             chooses the voice clone matching the specified
             configuration.
+        model_name (str):
+            Optional. The name of the model. If set, the
+            service will choose the model matching the
+            specified configuration.
     """
 
     language_code: str = proto.Field(
@@ -545,6 +553,10 @@ class VoiceSelectionParams(proto.Message):
         number=5,
         message="VoiceCloneParams",
     )
+    model_name: str = proto.Field(
+        proto.STRING,
+        number=6,
+    )
 
 
 class AudioConfig(proto.Message):
@@ -802,6 +814,11 @@ class StreamingSynthesisInput(proto.Message):
             may not be used with any other voices.
 
             This field is a member of `oneof`_ ``input_source``.
+        prompt (str):
+            This is system instruction supported only for
+            controllable voice models.
+
+            This field is a member of `oneof`_ ``_prompt``.
     """
 
     text: str = proto.Field(
@@ -814,6 +831,11 @@ class StreamingSynthesisInput(proto.Message):
         number=5,
         oneof="input_source",
     )
+    prompt: str = proto.Field(
+        proto.STRING,
+        number=6,
+        optional=True,
+    )
 
 
 class StreamingSynthesizeRequest(proto.Message):

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.27.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/services/text_to_speech/async_client.py

@@ -438,7 +438,7 @@ async def sample_synthesize_speech():
                 voice.language_code = "language_code_value"
 
                 audio_config = texttospeech_v1beta1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 request = texttospeech_v1beta1.SynthesizeSpeechRequest(
                     input=input,
@@ -547,7 +547,7 @@ def streaming_synthesize(
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> Awaitable[AsyncIterable[cloud_tts.StreamingSynthesizeResponse]]:
         r"""Performs bidirectional streaming speech synthesis:
-        receive audio while sending text.
+        receives audio while sending text.
 
         .. code-block:: python
 

packages/google-cloud-texttospeech/google/cloud/texttospeech_v1beta1/services/text_to_speech/client.py

@@ -856,7 +856,7 @@ def sample_synthesize_speech():
                 voice.language_code = "language_code_value"
 
                 audio_config = texttospeech_v1beta1.AudioConfig()
-                audio_config.audio_encoding = "PCM"
+                audio_config.audio_encoding = "M4A"
 
                 request = texttospeech_v1beta1.SynthesizeSpeechRequest(
                     input=input,
@@ -962,7 +962,7 @@ def streaming_synthesize(
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> Iterable[cloud_tts.StreamingSynthesizeResponse]:
         r"""Performs bidirectional streaming speech synthesis:
-        receive audio while sending text.
+        receives audio while sending text.
 
         .. code-block:: python