Models - Get Base Model

Reference

Service:: Azure AI Services

API Version:: 2024-11-15

Gets the base model identified by the given ID.

GET {endpoint}/speechtotext/models/base/{id}?api-version=2024-11-15

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string	Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).
id	path	True	string uuid	The identifier of the base model.
api-version	query	True	string	The requested api version.

Request Header

Name	Required	Type	Description
Ocp-Apim-Subscription-Key	True	string	Provide your cognitive services account key here.

Responses

Name	Type	Description
200 OK	BaseModel	OK
Other Status Codes	Error	An error occurred.

Security

Ocp-Apim-Subscription-Key

Provide your cognitive services account key here.

Type: apiKey
In: header

Examples

Get a base model

Sample request

HTTP

GET {endpoint}/speechtotext/models/base/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2024-11-15

Sample response

Status code:: 200

{
  "links": {
    "manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/models/base/827712a5-f942-4997-91c3-7c6cde35600b/manifest?api-version=2024-11-15"
  },
  "properties": {
    "deprecationDates": {
      "adaptationDateTime": "2022-11-04T00:00:00Z",
      "transcriptionDateTime": "2023-05-04T00:00:00Z"
    },
    "features": {
      "supportsAdaptationsWith": [
        "Language",
        "Acoustic"
      ],
      "supportsTranscriptionsSubmit": true,
      "supportsTranscriptionsTranscribe": true,
      "supportsEndpoints": true,
      "supportsTranscriptionsOnSpeechContainers": true,
      "supportedOutputFormats": [
        "Display",
        "Lexical"
      ]
    },
    "chargeForAdaptation": true
  },
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/base/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2024-11-15",
  "displayName": "en-US Base model",
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded"
}

Definitions

Name	Description
BaseModel	BaseModel
BaseModelDeprecationDates	BaseModelDeprecationDates
BaseModelFeatures	BaseModelFeatures
BaseModelLinks	BaseModelLinks
BaseModelProperties	BaseModelProperties
DatasetKind	DatasetKind
DetailedErrorCode	DetailedErrorCode
Error	Error
ErrorCode	ErrorCode
InnerError	InnerError
OutputFormatType	OutputFormatType
Status	Status

BaseModel

Object

BaseModel

Name	Type	Description
createdDateTime	string	The time-stamp when the object was created. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	The description of the object.
displayName	string	The display name of the object.
lastActionDateTime	string	The time-stamp when the current status was entered. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	BaseModelLinks	BaseModelLinks
locale	string	The locale of the contained data.
properties	BaseModelProperties	BaseModelProperties
self	string	The location of this entity.
status	Status	Status Describe the current state of the API.

BaseModelDeprecationDates

Object

BaseModelDeprecationDates

Name	Type	Description
adaptationDateTime	string	The date when adaptation becomes deprecated.
transcriptionDateTime	string	The date when transcription becomes deprecated.

BaseModelFeatures

Object

BaseModelFeatures

Name	Type	Description
supportedOutputFormats	OutputFormatType[]	Supported output formats.
supportsAdaptationsWith	DatasetKind[]	Supported dataset kinds to adapt the model.
supportsEndpoints	boolean	A value indicating whether creation of endpoints for live transcription is supported.
supportsTranscriptionsOnSpeechContainers	boolean	A value indicating whether this model can be used for transcription on speech container. This feature can be added on existing models when it becomes usable on speech container.
supportsTranscriptionsSubmit	boolean	A value indicating whether submission of transcription jobs is supported (POST /transcriptions:submit).
supportsTranscriptionsTranscribe	boolean	A value indicating whether the transcribe action is supported (POST /transcriptions:transcribe).

BaseModelLinks

Object

BaseModelLinks

Name	Type	Description
manifest	string	The location to get a manifest for this model to be used in the on-prem container. See operation "Models_GetCustomModelManifest" for more details.

BaseModelProperties

Object

BaseModelProperties

Name	Type	Description
chargeForAdaptation	boolean	A value indicating whether model adaptation is charged.
deprecationDates	BaseModelDeprecationDates	BaseModelDeprecationDates
features	BaseModelFeatures	BaseModelFeatures Features supported by the model.

DatasetKind

Enumeration

DatasetKind

Value	Description
Acoustic	An acoustic dataset.
AudioFiles	An audio files dataset.
Language	A language dataset.
LanguageMarkdown	A language markdown dataset.
OutputFormatting	Dataset that contains rules to customize inverse text normalization, capitalization, reformulation, profanity and also defines tests for dataset validation
Pronunciation	A pronunciation dataset.

DetailedErrorCode

Enumeration

DetailedErrorCode

Value	Description
AudioLengthLimitExceeded	The audio file is longer than the maximum allowed duration.
BadChannelConfiguration	There is a mismatch between audio channels in the data, in the configuration, or the requirements of the application.
DataImportFailed	Data import failed.
DeleteNotAllowed	Delete not allowed.
DeployNotAllowed	Deploy not allowed.
DeployingFailedModel	Deploying failed model.
EmptyAudioFile	The audio file is empty.
EmptyRequest	Empty Request.
EndpointCannotBeDefault	Endpoint cannot be default.
EndpointLoggingNotSupported	Endpoint logging not supported.
EndpointNotUpdatable	Endpoint not updatable.
EndpointWithoutLogging	Endpoint without logging.
ExceededNumberOfRecordingsUris	Exceeded number of recordings uris.
FailedDataset	Failed dataset.
Forbidden	Forbidden.
InUseViolation	In use violation.
InaccessibleCustomerStorage	Inaccessible customer storage.
InvalidAdaptationMapping	Invalid adaptation mapping.
InvalidAudioFormat	The format of input audio is not supported.
InvalidBaseModel	Invalid base model.
InvalidCallbackUri	Invalid callback uri.
InvalidChannelSpecification	The selection of channels in the transcription request is not supported (e.g., neither 0 nor 1 have been selected.)
InvalidChannels	Invalid channels.
InvalidCollection	Invalid collection.
InvalidDataset	Invalid dataset.
InvalidDocument	Invalid Document.
InvalidDocumentBatch	Invalid Document Batch.
InvalidLocale	Invalid locale.
InvalidLogDate	Invalid log date.
InvalidLogEndTime	Invalid log end time.
InvalidLogId	Invalid log id.
InvalidLogStartTime	Invalid log start time.
InvalidModel	Invalid model.
InvalidModelUri	Invalid model uri.
InvalidParameter	Invalid parameter.
InvalidParameterValue	Invalid parameter value.
InvalidPayload	Invalid payload.
InvalidPermissions	Invalid permissions.
InvalidPrerequisite	Invalid prerequisite.
InvalidProductId	Invalid product id.
InvalidProject	Invalid project.
InvalidProjectKind	Invalid project kind.
InvalidRecordingsUri	Invalid recordings uri.
InvalidRequestBodyFormat	Invalid request body format.
InvalidSasValidityDuration	Invalid sas validity duration.
InvalidSkipTokenForLogs	Invalid skip token for logs.
InvalidSourceAzureResourceId	Invalid source Azure resource ID.
InvalidSubscription	Invalid subscription.
InvalidTest	Invalid test.
InvalidTimeToLive	Invalid time to live.
InvalidTopForLogs	Invalid top for logs.
InvalidTranscription	Invalid transcription.
InvalidWebHookEventKind	Invalid web hook event kind.
MissingInputRecords	Missing Input Records.
ModelCopyAuthorizationExpired	Expired ModelCopyAuthorization.
ModelDeploymentNotCompleteState	Model deployment not complete state.
ModelDeprecated	Model deprecated.
ModelExists	Model exists.
ModelMismatch	Model mismatch.
ModelNotDeployable	Model not deployable.
ModelVersionIncorrect	Model Version Incorrect.
MultipleLanguagesIdentified	Language Identification recognized multiple languages. No dominant language could be determined.
NoLanguageIdentified	Language Identification did not recognize any language.
NoUtf8WithBom	No utf8 with bom.
OnlyOneOfUrlsOrContainerOrDataset	Only one of urls or container or dataset.
ProjectGenderMismatch	Project gender mismatch.
QuotaViolation	Quota violation.
SingleDefaultEndpoint	Single default endpoint.
SkuLimitsExist	Sku limits exist.
SubscriptionNotFound	Subscription not found.
UnexpectedError	Unexpected error.
UnsupportedClassBasedAdaptation	Unsupported class based adaptation.
UnsupportedDelta	Unsupported delta.
UnsupportedDynamicConfiguration	Unsupported dynamic configuration.
UnsupportedFilter	Unsupported filter.
UnsupportedLanguageCode	Unsupported language code.
UnsupportedOrderBy	Unsupported order by.
UnsupportedPagination	Unsupported pagination.
UnsupportedTimeRange	Unsupported time range.

Error

Object

Error

Name	Type	Description
code	ErrorCode	ErrorCode High level error codes.
details	Error[]	Additional supportive details regarding the error and/or expected policies.
innerError	InnerError	InnerError New Inner Error format which conforms to Cognitive Services API Guidelines which is available at https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. This contains required properties ErrorCode, message and optional properties target, details(key value pair), inner error(this can be nested).
message	string	High level error message.
target	string	The source of the error. For example it would be "documents" or "document id" in case of invalid document.

ErrorCode

Enumeration

ErrorCode

Value	Description
Conflict	Representing the conflict error code.
Forbidden	Representing the forbidden error code.
InternalCommunicationFailed	Representing the internal communication failed error code.
InternalServerError	Representing the internal server error error code.
InvalidArgument	Representing the invalid argument error code.
InvalidRequest	Representing the invalid request error code.
NotAllowed	Representing the not allowed error code.
NotFound	Representing the not found error code.
PipelineError	Representing the pipeline error error code.
ServiceUnavailable	Representing the service unavailable error code.
TooManyRequests	Representing the too many requests error code.
Unauthorized	Representing the unauthorized error code.
UnprocessableEntity	Representing the unprocessable entity error code.
UnsupportedMediaType	Representing the unsupported media type error code.

InnerError

Object

InnerError

Name	Type	Description
code	DetailedErrorCode	DetailedErrorCode Detailed error code enum.
details	object	Additional supportive details regarding the error and/or expected policies.
innerError	InnerError	InnerError New Inner Error format which conforms to Cognitive Services API Guidelines which is available at https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. This contains required properties ErrorCode, message and optional properties target, details(key value pair), inner error(this can be nested).
message	string	High level error message.
target	string	The source of the error. For example it would be "documents" or "document id" in case of invalid document.

OutputFormatType

Enumeration

OutputFormatType

Value	Description
Display	Model supports display formatting transcriptions output or endpoints.
Lexical	Model provides the transcription output without formatting.

Status

Enumeration

Status

Value	Description
Failed	The long running operation has failed.
NotStarted	The long running operation has not yet started.
Running	The long running operation is currently processing.
Succeeded	The long running operation has successfully completed.

Share via

Models - Get Base Model

URI Parameters

Request Header

Responses

Security

Ocp-Apim-Subscription-Key

Examples

Get a base model

Sample request

Sample response

Definitions

BaseModel

BaseModelDeprecationDates

BaseModelFeatures

BaseModelLinks

BaseModelProperties

DatasetKind

DetailedErrorCode

Error

ErrorCode

InnerError

OutputFormatType

Status

Additional resources