feat(0.10.0): Phase 8 — Speak REST polish and STT/TTS shared cleanup

  8a. Speak REST: add speed, callback, callback_method, tag, mip_opt_out
  8b. Speak Model: replace 13-variant enum with newtype + const fn
      constructors for all 62 spec'd Aura voices, plus Model::custom
  8c. STT: add mip_opt_out builder
  8d. STT WS enum extensions: Encoding::{Alaw, OggOpus},
      Redact::AggressiveNumbers, CallbackMethod::{GET, DELETE}
  8e. Drop undocumented STT fields: ner, alternatives,
      diarize_version, keyword_boost_legacy, ListenMetadata.language

  BREAKING CHANGE: speak::options::Model variants → constructors
  (e.g. Model::AuraAsteriaEn → Model::aura_asteria_en()),
  Model::CustomId(s) → Model::custom(s). Removes deprecated STT
  fields listed above.

Author: GregHolmes

examples/speak/rest/text_to_speech_to_file.rs

@@ -13,7 +13,7 @@ async fn main() -> Result<(), DeepgramError> {
     let dg_client = Deepgram::new(&deepgram_api_key)?;
 
     let options = Options::builder()
-        .model(Model::AuraAsteriaEn)
+        .model(Model::aura_asteria_en())
         .encoding(Encoding::Linear16)
         .sample_rate(16000)
         .container(Container::Wav)

examples/speak/rest/text_to_speech_to_stream.rs

@@ -98,7 +98,7 @@ async fn main() -> Result<(), DeepgramError> {
     let channels = 1;
 
     let options = Options::builder()
-        .model(Model::AuraAsteriaEn)
+        .model(Model::aura_asteria_en())
         .encoding(Encoding::Linear16)
         .sample_rate(sample_rate)
         .container(Container::Wav)

examples/speak/websocket/flush_clear.rs

@@ -41,7 +41,7 @@ async fn main() -> Result<(), DeepgramError> {
     let (mut handle, mut stream) = dg
         .text_to_speech()
         .websocket()
-        .model(Model::AuraAsteriaEn)
+        .model(Model::aura_asteria_en())
         .encoding(Encoding::Linear16)
         .sample_rate(24_000)
         .start()

examples/speak/websocket/simple_stream.rs

@@ -42,7 +42,7 @@ async fn main() -> Result<(), DeepgramError> {
     let (mut handle, mut stream) = dg
         .text_to_speech()
         .websocket()
-        .model(Model::AuraAsteriaEn)
+        .model(Model::aura_asteria_en())
         .encoding(Encoding::Linear16)
         .sample_rate(24_000)
         .start()

examples/transcription/rest/prerecorded_from_url.rs

@@ -26,7 +26,6 @@ async fn main() -> Result<(), DeepgramError> {
         .redact([Redact::Pci, Redact::Other(String::from("cvv"))])
         .detect_language(DetectLanguage::Restricted(vec![Language::en, Language::es]))
         .diarize(true)
-        .diarize_version("2021-07-14.0")
         .filler_words(true)
         .smart_format(true)
         .encoding(Encoding::Linear16)

src/common/batch_response.rs

@@ -62,12 +62,6 @@ pub struct ListenMetadata {
     #[allow(missing_docs)]
     pub channels: usize,
 
-    /// Top-level language. Not in the current
-    /// `ListenV1ResponseMetadata` schema (the language is on each
-    /// channel via `ChannelResult.detected_language`); kept for
-    /// backward compatibility, will be removed in 0.10.0 (Phase 8e).
-    pub language: Option<String>,
-
     /// Model UUIDs that served the request.
     #[serde(default, skip_serializing_if = "Option::is_none")]
     pub models: Option<Vec<String>>,