- [JSON representation](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#SCHEMA_REPRESENTATION)
- [SpeechContext](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#SpeechContext)
  - [JSON representation](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#SpeechContext.SCHEMA_REPRESENTATION)

Instructs the speech recognizer how to process the audio content.

| JSON representation |
|---|
| ``` { "audioEncoding": enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.AudioEncoding`), "sampleRateHertz": integer, "languageCode": string, "enableWordInfo": boolean, "phraseHints": [ string ], "speechContexts": [ { object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#SpeechContext`) } ], "model": string, "modelVariant": enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.SpeechModelVariant`), "singleUtterance": boolean, "enableVoiceActivityEvents": boolean, "disableNoSpeechRecognizedEvent": boolean, "enableAutomaticPunctuation": boolean, "alternativeLanguageCodes": [ string ], "phraseSets": [ string ], "profanityFilter": boolean, "optOutConformerModelMigration": boolean, "geminiAsrConfig": { object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.GeminiAsrConfig`) }, "useGeminiAsr": boolean, "disableInterimInputTranscripts": boolean } ``` |

| Fields ||
|---|---|
| `audioEncoding` | ``enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.AudioEncoding`)`` Required. Audio encoding of the audio content to process. |
| `sampleRateHertz` | `integer` Required. Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details. |
| `languageCode` | `string` Required. The language of the supplied audio. Dialogflow does not do translations. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. Note that queries in the same session do not necessarily need to specify the same language. If not set, the language is inferred from the `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.FIELDS.stt_config`. |
| `enableWordInfo` | `boolean` If `true`, Dialogflow returns `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/ConversationEvent#SpeechWordInfo` in `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/ConversationEvent#StreamingRecognitionResult` with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information. |
| `phraseHints[] (deprecated)` | `string` > [!WARNING] > This item is deprecated! A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [`speechContexts`]() instead. If you specify both [`phraseHints`]() and [`speechContexts`](), Dialogflow will treat the [`phraseHints`]() as a single additional [`SpeechContext`](). |
| `speechContexts[]` | ``object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#SpeechContext`)`` Context information to assist speech recognition. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. |
| `model` | `string` Optional. Which Speech model to select for the given request. For more information, see [Speech models](https://cloud.google.com/dialogflow/es/docs/speech-models). |
| `modelVariant` | ``enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.SpeechModelVariant`)`` Which variant of the `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/InputAudioConfig#FIELDS.model` to use. |
| `singleUtterance` | `boolean` If `false` (default), recognition does not cease until the client closes the stream. If `true`, the recognizer will detect a single spoken utterance in input audio. Recognition ceases when it detects the audio's voice has stopped or paused. In this case, once a detected intent is received, the client should close the stream and start a new request with a new stream as needed. Note: This setting is relevant only for streaming methods. Note: When specified, InputAudioConfig.single_utterance takes precedence over StreamingDetectIntentRequest.single_utterance. |
| `enableVoiceActivityEvents` | `boolean` Optional. If `true`, responses with voice activity speech events will be returned as they are detected. Note: This setting is relevant only for streaming methods. |
| `disableNoSpeechRecognizedEvent` | `boolean` Only used in `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversations.participants/analyzeContent#google.cloud.dialogflow.v2.Participants.AnalyzeContent` and `Participants.StreamingAnalyzeContent`. If `false` and recognition doesn't return any result, trigger `NO_SPEECH_RECOGNIZED` event to Dialogflow agent. |
| `enableAutomaticPunctuation` | `boolean` Enable automatic punctuation option at the speech backend. |
| `alternativeLanguageCodes[]` | `string` Optional. A list of up to 3 additional [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags, listing possible alternative languages of the supplied audio. See [Language Support](https://cloud.google.com/dialogflow/docs/reference/language) for a list of the currently supported language codes. If alternative languages are listed, recognition result will contain recognition in the most likely language detected including the main languageCode. The recognition result will include the language tag of the language detected in the audio. Extra language codes will be ignored. |
| `phraseSets[]` | `string` A collection of phrase set resources to use for speech adaptation. |
| `profanityFilter` | `boolean` Optional. If `true`, filters out profanities in transcripts, replacing all but the initial character in each filtered word with asterisks, for instance, "f\*\*\*". Supported for Cloud Speech-to-Text and for Gemini ASR (`useGeminiAsr` is `true`). For Gemini ASR the built-in profanity list covers English only. |
| `optOutConformerModelMigration` | `boolean` If `true`, the request will opt out for STT conformer model migration. This field will be deprecated once force migration takes place in June 2024. Please refer to [Dialogflow ES Speech model migration](https://cloud.google.com/dialogflow/es/docs/speech-model-migration). |
| `geminiAsrConfig` | ``object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.GeminiAsrConfig`)`` Optional. Configuration for using Gemini ASR models served via Vertex AI. This field is only used when `useGeminiAsr` is true. |
| `useGeminiAsr` | `boolean` Optional. If true, Gemini ASR will be used for transcription instead of Cloud Speech-to-Text. If false, Cloud Speech-to-Text will be used. If unset, this setting is inherited from the ConversationProfile. For `StreamingAnalyzeContent`, if the ConversationProfile enables Gemini ASR (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles#ConversationProfile.SpeechToTextConfig.FIELDS.use_gemini_asr` is true), Gemini ASR is used even if this field is false. |
| `disableInterimInputTranscripts` | `boolean` Optional. Disables emission of interim input transcriptions when set to `true`. |

## SpeechContext

Hints for the speech recognizer to help with recognition in a specific conversation state.

| JSON representation |
|---|
| ``` { "phrases": [ string ], "boost": number } ``` |

| Fields ||
|---|---|
| `phrases[]` | `string` Optional. A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. This list can be used to: - improve accuracy for words and phrases you expect the user to say, e.g. typical commands for your Dialogflow agent - add additional words to the speech recognizer vocabulary - ... See the [Cloud Speech documentation](https://cloud.google.com/speech-to-text/quotas) for usage limits. |
| `boost` | `number` Optional. Boost for this context compared to other contexts: - If the boost is positive, Dialogflow will increase the probability that the phrases in this context are recognized over similar sounding phrases. - If the boost is unspecified or non-positive, Dialogflow will not apply any boost. Dialogflow recommends that you use boosts in the range (0, 20\] and that you find a value that fits your use case with binary search. |