com.ibm.watson.developer_cloud.speech_to_text.v1.model

Class RecognizeOptions

java.lang.Object

com.ibm.watson.developer_cloud.service.model.GenericModel

com.ibm.watson.developer_cloud.speech_to_text.v1.model.RecognizeOptions

All Implemented Interfaces:

ObjectModel

public class RecognizeOptions
extends GenericModel

The recognize options.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RecognizeOptions.Builder Builder.
static interface	RecognizeOptions.ContentType The type of the input: audio/basic, audio/flac, audio/l16, audio/mp3, audio/mpeg, audio/mulaw, audio/ogg, audio/ogg;codecs=opus, audio/ogg;codecs=vorbis, audio/wav, audio/webm, audio/webm;codecs=opus, audio/webm;codecs=vorbis, or multipart/form-data.
static interface	RecognizeOptions.Model The identifier of the model to be used for the recognition request.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	acousticCustomizationId() Gets the acousticCustomizationId.
java.io.InputStream	audio() Gets the audio.
java.lang.String	baseModelVersion() Gets the baseModelVersion.
java.lang.String	contentType() Gets the contentType.
java.lang.String	customizationId() Gets the customizationId.
java.lang.Double	customizationWeight() Gets the customizationWeight.
java.lang.Long	inactivityTimeout() Gets the inactivityTimeout.
java.lang.Boolean	interimResults() Gets the interimResults.
java.util.List<java.lang.String>	keywords() Gets the keywords.
java.lang.Float	keywordsThreshold() Gets the keywordsThreshold.
java.lang.Long	maxAlternatives() Gets the maxAlternatives.
java.lang.String	model() Gets the model.
RecognizeOptions.Builder	newBuilder() New builder.
java.lang.Boolean	profanityFilter() Gets the profanityFilter.
java.lang.Boolean	smartFormatting() Gets the smartFormatting.
java.lang.Boolean	speakerLabels() Gets the speakerLabels.
java.lang.Boolean	timestamps() Gets the timestamps.
java.lang.Float	wordAlternativesThreshold() Gets the wordAlternativesThreshold.
java.lang.Boolean	wordConfidence() Gets the wordConfidence.

Methods inherited from class com.ibm.watson.developer_cloud.service.model.GenericModel

equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

newBuilder

public RecognizeOptions.Builder newBuilder()

New builder.

Returns:

a RecognizeOptions builder

model

public java.lang.String model()

Gets the model. The identifier of the model to be used for the recognition request. (Use `GET /v1/models` for a list of available models.).

Returns:

the model

customizationId

public java.lang.String customizationId()

Gets the customizationId. The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.

Returns:

the customizationId

acousticCustomizationId

public java.lang.String acousticCustomizationId()

Gets the acousticCustomizationId. The GUID of a custom acoustic model that is to be used with the request. The base model of the specified custom acoustic model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom acoustic model is used.

Returns:

the acousticCustomizationId

customizationWeight

public java.lang.Double customizationWeight()

Gets the customizationWeight. If you specify a `customization_id` with the request, you can use the `customization_weight` parameter to tell the service how much weight to give to words from the custom language model compared to those from the base model for speech recognition. Specify a value between 0.0 and 1.0. Unless a different customization weight was specified for the custom model when it was trained, the default value is 0.3. A customization weight that you specify overrides a weight that was specified when the custom model was trained. The default value yields the best performance in general. Assign a higher value if your audio makes frequent use of OOV words from the custom model. Use caution when setting the weight: a higher value can improve the accuracy of phrases from the custom model's domain, but it can negatively affect performance on non-domain phrases.

Returns:

the customizationWeight

baseModelVersion

public java.lang.String baseModelVersion()

Gets the baseModelVersion. The baseModelVersion of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).

Returns:

the baseModelVersion

audio

public java.io.InputStream audio()

Gets the audio.

Returns:

the audio

contentType

public java.lang.String contentType()

Gets the contentType. The type of the input: audio/basic, audio/flac, audio/l16, audio/mp3, audio/mpeg, audio/mulaw, audio/ogg, audio/ogg;codecs=opus, audio/ogg;codecs=vorbis, audio/wav, audio/webm, audio/webm;codecs=opus, audio/webm;codecs=vorbis, or multipart/form-data.

Returns:

the contentType

inactivityTimeout

public java.lang.Long inactivityTimeout()

Gets the inactivityTimeout. NON-MULTIPART ONLY: The time in seconds after which, if only silence (no speech) is detected in submitted audio, the connection is closed with a 400 error. Useful for stopping audio submission from a live microphone when a user simply walks away. Use `-1` for infinity.

Returns:

the inactivityTimeout

keywords

public java.util.List<java.lang.String> keywords()

Gets the keywords. NON-MULTIPART ONLY: Array of keyword strings to spot in the audio. Each keyword string can include one or more tokens. Keywords are spotted only in the final hypothesis, not in interim results. If you specify any keywords, you must also specify a keywords threshold. Omit the parameter or specify an empty array if you do not need to spot keywords.

Returns:

the keywords

keywordsThreshold

public java.lang.Float keywordsThreshold()

Gets the keywordsThreshold. NON-MULTIPART ONLY: Confidence value that is the lower bound for spotting a keyword. A word is considered to match a keyword if its confidence is greater than or equal to the threshold. Specify a probability between 0 and 1 inclusive. No keyword spotting is performed if you omit the parameter. If you specify a threshold, you must also specify one or more keywords.

Returns:

the keywordsThreshold

maxAlternatives

public java.lang.Long maxAlternatives()

Gets the maxAlternatives. NON-MULTIPART ONLY: Maximum number of alternative transcripts to be returned. By default, a single transcription is returned.

Returns:

the maxAlternatives

wordAlternativesThreshold

public java.lang.Float wordAlternativesThreshold()

Gets the wordAlternativesThreshold. NON-MULTIPART ONLY: Confidence value that is the lower bound for identifying a hypothesis as a possible word alternative (also known as "Confusion Networks"). An alternative word is considered if its confidence is greater than or equal to the threshold. Specify a probability between 0 and 1 inclusive. No alternative words are computed if you omit the parameter.

Returns:

the wordAlternativesThreshold

wordConfidence

public java.lang.Boolean wordConfidence()

Gets the wordConfidence. NON-MULTIPART ONLY: If `true`, confidence measure per word is returned.

Returns:

the wordConfidence

timestamps

public java.lang.Boolean timestamps()

Gets the timestamps. NON-MULTIPART ONLY: If `true`, time alignment for each word is returned.

Returns:

the timestamps

profanityFilter

public java.lang.Boolean profanityFilter()

Gets the profanityFilter. NON-MULTIPART ONLY: If `true` (the default), filters profanity from all output except for keyword results by replacing inappropriate words with a series of asterisks. Set the parameter to `false` to return results with no censoring. Applies to US English transcription only.

Returns:

the profanityFilter

smartFormatting

public java.lang.Boolean smartFormatting()

Gets the smartFormatting. NON-MULTIPART ONLY: If `true`, converts dates, times, series of digits and numbers, phone numbers, currency values, and Internet addresses into more readable, conventional representations in the final transcript of a recognition request. If `false` (the default), no formatting is performed. Applies to US English transcription only.

Returns:

the smartFormatting

speakerLabels

public java.lang.Boolean speakerLabels()

Gets the speakerLabels. NON-MULTIPART ONLY: Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter. To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).

Returns:

the speakerLabels

interimResults

public java.lang.Boolean interimResults()

Gets the interimResults. Indicates whether the service is to return interim results. If true, interim results are returned as a stream of JSON SpeechRecognitionResults objects. If false (the default), the response is a single SpeechRecognitionResults object with final results only.

Returns:

the interimResults