Package com.google.genai.gaos.models.voices

Class VoiceOutput.Builder

java.lang.Object
com.google.genai.gaos.models.voices.VoiceOutput.Builder
Enclosing class:
VoiceOutput
public static final class VoiceOutput.Builder extends Object

  • Method Details

    • accent

      public VoiceOutput.Builder accent(@Nullable String accent)
      Optional. Regional accent descriptor (e.g. "American", "British").

    • context

      public VoiceOutput.Builder context(@Nullable String context)
      Optional. Optimal usage context or domain (e.g. "Conversational", "Audiobook", "News").

    • description

      public VoiceOutput.Builder description(@Nullable String description)
      Optional. Descriptive summary of vocal timbre, personality, and tone.

    • displayName

      public VoiceOutput.Builder displayName(@Nullable String displayName)
      Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.

    • expireTime

      public VoiceOutput.Builder expireTime(@Nullable OffsetDateTime expireTime)
      Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`"prebuilt"`), which do not expire.

    • gender

      public VoiceOutput.Builder gender(@Nullable String gender)
      Optional. Perceived voice gender presentation (e.g. "female", "male", "neutral").

    • id

      public VoiceOutput.Builder id(@Nullable String id)
      Output only. The unique identifier of the voice.

      * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`"prebuilt"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.

    • key

      public VoiceOutput.Builder key(@Nullable String key)
      Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `"replicated"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis.

    • languageCode

      public VoiceOutput.Builder languageCode(@Nullable String languageCode)
      Optional. Primary BCP-47 language tag (e.g. "en-US", "fr-FR").

    • model

      public VoiceOutput.Builder model(@Nullable String model)
      Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`"prompted"` and `"replicated"`); unset for `"prebuilt"` voices. Created voices can be synthesized across any supported TTS synthesis model.

    • persona

      public VoiceOutput.Builder persona(@Nullable String persona)
      Optional. Intended persona or character archetype (e.g. "Warm, Friendly", "Narrator").

    • pitch

      public VoiceOutput.Builder pitch(@Nullable Pitch pitch)

    • prompted

      public VoiceOutput.Builder prompted(@Nullable PromptedVoice prompted)
      Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `"prompted"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.

    • regionCode

      public VoiceOutput.Builder regionCode(@Nullable String regionCode)
      Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. "US", "GB", "001").

    • sampleAudio

      public VoiceOutput.Builder sampleAudio(@Nullable AudioData sampleAudio)
      Audio payload used for voice creation.

    • type

      public VoiceOutput.Builder type(@Nonnull VoiceType type)

    • usage

      public VoiceOutput.Builder usage(@Nullable Usage usage)
      Statistics on the interaction request's token usage.

    • build

      public VoiceOutput build()