com.ibm.watson.speech_to_text.v1.model.LanguageModel Maven / Gradle / Ivy
Show all versions of speech-to-text Show documentation
/*
* (C) Copyright IBM Corp. 2018, 2021.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
* an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
*/
package com.ibm.watson.speech_to_text.v1.model;
import com.google.gson.annotations.SerializedName;
import com.ibm.cloud.sdk.core.service.model.GenericModel;
import java.util.List;
/** Information about an existing custom language model. */
public class LanguageModel extends GenericModel {
/**
* The current status of the custom language model: * `pending`: The model was created but is
* waiting either for valid training data to be added or for the service to finish analyzing added
* data. * `ready`: The model contains valid data and is ready to be trained. If the model
* contains a mix of valid and invalid resources, you need to set the `strict` parameter to
* `false` for the training to proceed. * `training`: The model is currently being trained. *
* `available`: The model is trained and ready to use. * `upgrading`: The model is currently being
* upgraded. * `failed`: Training of the model failed.
*/
public interface Status {
/** pending. */
String PENDING = "pending";
/** ready. */
String READY = "ready";
/** training. */
String TRAINING = "training";
/** available. */
String AVAILABLE = "available";
/** upgrading. */
String UPGRADING = "upgrading";
/** failed. */
String FAILED = "failed";
}
@SerializedName("customization_id")
protected String customizationId;
protected String created;
protected String updated;
protected String language;
protected String dialect;
protected List versions;
protected String owner;
protected String name;
protected String description;
@SerializedName("base_model_name")
protected String baseModelName;
protected String status;
protected Long progress;
protected String error;
protected String warnings;
/**
* Gets the customizationId.
*
* The customization ID (GUID) of the custom language model. The [Create a custom language
* model](#createlanguagemodel) method returns only this field of the object; it does not return
* the other fields.
*
* @return the customizationId
*/
public String getCustomizationId() {
return customizationId;
}
/**
* Gets the created.
*
*
The date and time in Coordinated Universal Time (UTC) at which the custom language model was
* created. The value is provided in full ISO 8601 format (`YYYY-MM-DDThh:mm:ss.sTZD`).
*
* @return the created
*/
public String getCreated() {
return created;
}
/**
* Gets the updated.
*
*
The date and time in Coordinated Universal Time (UTC) at which the custom language model was
* last modified. The `created` and `updated` fields are equal when a language model is first
* added but has yet to be updated. The value is provided in full ISO 8601 format
* (YYYY-MM-DDThh:mm:ss.sTZD).
*
* @return the updated
*/
public String getUpdated() {
return updated;
}
/**
* Gets the language.
*
*
The language identifier of the custom language model (for example, `en-US`).
*
* @return the language
*/
public String getLanguage() {
return language;
}
/**
* Gets the dialect.
*
*
The dialect of the language for the custom language model. For non-Spanish models, the field
* matches the language of the base model; for example, `en-US` for either of the US English
* language models. For Spanish models, the field indicates the dialect for which the model was
* created: * `es-ES` for Castilian Spanish (`es-ES` models) * `es-LA` for Latin American Spanish
* (`es-AR`, `es-CL`, `es-CO`, and `es-PE` models) * `es-US` for Mexican (North American) Spanish
* (`es-MX` models)
*
*
Dialect values are case-insensitive.
*
* @return the dialect
*/
public String getDialect() {
return dialect;
}
/**
* Gets the versions.
*
*
_For custom models that are based on previous-generation models_, a list of the available
* versions of the custom language model. Each element of the array indicates a version of the
* base model with which the custom model can be used. Multiple versions exist only if the custom
* model has been upgraded; otherwise, only a single version is shown.
*
*
_For custom models that are based on next-generation models_, a single version of the custom
* model. Only one version of a custom model that is based on a next-generation model is ever
* available, and upgrading does not apply.
*
* @return the versions
*/
public List getVersions() {
return versions;
}
/**
* Gets the owner.
*
* The GUID of the credentials for the instance of the service that owns the custom language
* model.
*
* @return the owner
*/
public String getOwner() {
return owner;
}
/**
* Gets the name.
*
*
The name of the custom language model.
*
* @return the name
*/
public String getName() {
return name;
}
/**
* Gets the description.
*
*
The description of the custom language model.
*
* @return the description
*/
public String getDescription() {
return description;
}
/**
* Gets the baseModelName.
*
*
The name of the language model for which the custom language model was created.
*
* @return the baseModelName
*/
public String getBaseModelName() {
return baseModelName;
}
/**
* Gets the status.
*
*
The current status of the custom language model: * `pending`: The model was created but is
* waiting either for valid training data to be added or for the service to finish analyzing added
* data. * `ready`: The model contains valid data and is ready to be trained. If the model
* contains a mix of valid and invalid resources, you need to set the `strict` parameter to
* `false` for the training to proceed. * `training`: The model is currently being trained. *
* `available`: The model is trained and ready to use. * `upgrading`: The model is currently being
* upgraded. * `failed`: Training of the model failed.
*
* @return the status
*/
public String getStatus() {
return status;
}
/**
* Gets the progress.
*
*
A percentage that indicates the progress of the custom language model's current training. A
* value of `100` means that the model is fully trained. **Note:** The `progress` field does not
* currently reflect the progress of the training. The field changes from `0` to `100` when
* training is complete.
*
* @return the progress
*/
public Long getProgress() {
return progress;
}
/**
* Gets the error.
*
*
If an error occurred while adding a grammar file to the custom language model, a message
* that describes an `Internal Server Error` and includes the string `Cannot compile grammar`. The
* status of the custom model is not affected by the error, but the grammar cannot be used with
* the model.
*
* @return the error
*/
public String getError() {
return error;
}
/**
* Gets the warnings.
*
*
If the request included unknown parameters, the following message: `Unexpected query
* parameter(s) ['parameters'] detected`, where `parameters` is a list that includes a quoted
* string for each unknown parameter.
*
* @return the warnings
*/
public String getWarnings() {
return warnings;
}
}