Models - Get Custom Model
Hämtar modellen som identifieras av det angivna ID:t.
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com). |
id
|
path | True |
string uuid |
Modellens identifierare. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK Sidhuvuden Retry-After: integer |
|
Other Status Codes |
Ett fel inträffade. |
Säkerhet
Ocp-Apim-Subscription-Key
Ange din cognitive services-kontonyckel här.
Typ:
apiKey
I:
header
Authorization
Ange en åtkomsttoken från JWT som returneras av STS i den här regionen. Se till att lägga till hanteringsomfånget i token genom att lägga till följande frågesträng i STS-URL:en: ?scope=speechservicesmanagement
Typ:
apiKey
I:
header
Exempel
Get a model |
Get a model with custom model weight |
Get a model
Exempelbegäran
GET {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b
Exempelsvar
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b",
"baseModel": {
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
},
"datasets": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
}
],
"links": {
"manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
"copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
"copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
},
"properties": {
"deprecationDates": {
"transcriptionDateTime": "2023-05-04T00:00:00Z"
},
"customModelWeightPercent": 30,
"features": {
"supportsTranscriptions": true,
"supportsEndpoints": true,
"supportsTranscriptionsOnSpeechContainers": false,
"supportedOutputFormats": [
"Lexical",
"Display"
]
}
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Running",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Language model",
"description": "This is a language model"
}
Get a model with custom model weight
Exempelbegäran
GET {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b
Exempelsvar
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b",
"baseModel": {
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
},
"datasets": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
}
],
"links": {
"manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
"copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
"copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
},
"properties": {
"deprecationDates": {
"transcriptionDateTime": "2023-05-04T00:00:00Z"
},
"customModelWeightPercent": 42,
"features": {
"supportsTranscriptions": true,
"supportsEndpoints": true,
"supportsTranscriptionsOnSpeechContainers": false,
"supportedOutputFormats": [
"Lexical",
"Display"
]
}
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Running",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Language model",
"description": "This is a language model"
}
Definitioner
Name | Description |
---|---|
Custom |
CustomModel |
Custom |
CustomModelDeprecationDates |
Custom |
CustomModelFeatures |
Custom |
CustomModelLinks |
Custom |
CustomModelEgenskaper |
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Fel |
Error |
Felkod |
Inner |
InnerError |
Output |
OutputFormatType |
Status |
Status |
CustomModel
CustomModel
Name | Typ | Description |
---|---|---|
baseModel |
EntityReference |
|
createdDateTime |
string |
Tidsstämpeln när objektet skapades. Tidsstämpeln är kodad som ISO 8601 datum- och tidsformat ("ÅÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
De anpassade egenskaperna för den här entiteten. Den maximala tillåtna nyckellängden är 64 tecken, den maximala tillåtna värdelängden är 256 tecken och antalet tillåtna poster är 10. |
datasets |
Datauppsättningar som används för anpassning. |
|
description |
string |
Beskrivningen av objektet. |
displayName |
string |
Visningsnamnet för objektet. |
lastActionDateTime |
string |
Tidsstämpeln när den aktuella statusen angavs. Tidsstämpeln är kodad som ISO 8601 datum- och tidsformat ("ÅÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
CustomModelLinks |
|
locale |
string |
Nationella inställningar för inneslutna data. |
project |
EntityReference |
|
properties |
CustomModelEgenskaper |
|
self |
string |
Platsen för den här entiteten. |
status |
Status |
|
text |
string |
Den text som används för att anpassa den här språkmodellen. |
CustomModelDeprecationDates
CustomModelDeprecationDates
Name | Typ | Description |
---|---|---|
transcriptionDateTime |
string |
Det datum då transkriptionen blir inaktuell. |
CustomModelFeatures
CustomModelFeatures
Name | Typ | Description |
---|---|---|
supportedOutputFormats |
Utdataformat som stöds. |
|
supportsEndpoints |
boolean |
Ett värde som anger om skapande av slutpunkter för live-transkription stöds. |
supportsTranscriptions |
boolean |
Ett värde som anger om batch-transkription stöds. |
supportsTranscriptionsOnSpeechContainers |
boolean |
Ett värde som anger om den här modellen kan användas för transkription i talcontainern. Den här funktionen kan läggas till på befintliga modeller när den blir användbar i talcontainern. |
CustomModelLinks
CustomModelLinks
Name | Typ | Description |
---|---|---|
copy |
string |
Platsen för modellkopieringsåtgärden. Mer information finns i åtgärden "Models_Copy". |
copyTo |
string |
Platsen för den föråldrade modellkopieringsåtgärden. Mer information finns i åtgärden "Models_CopyTo". |
files |
string |
Platsen för att hämta alla filer i den här entiteten. Mer information finns i åtgärden "Models_ListFiles". |
manifest |
string |
Platsen för att hämta ett manifest för den här modellen som ska användas i den lokala containern. Mer information finns i åtgärden "Models_GetCustomModelManifest". |
CustomModelProperties
CustomModelEgenskaper
Name | Typ | Description |
---|---|---|
customModelWeightPercent |
integer |
Vikten för den anpassade modellen mellan 1 (1 % anpassad modell och 99 % basmodell) och 100 (100 % anpassad modell och 0 % basmodell). När den här egenskapen inte har angetts väljer tjänsten ett lämpligt värde (hämta modellen för att hämta den valda vikten). Börja utan att använda den här egenskapen. Om det behövs väljer du en större (eller mindre) vikt för att öka (eller minska) effekten av den anpassade modellen. |
deprecationDates |
CustomModelDeprecationDates |
|
string |
E-postadressen som e-postaviseringar ska skickas till om åtgärden slutförs. Värdet tas bort när e-postmeddelandet har skickats. |
|
error |
EntityError |
|
features |
CustomModelFeatures |
DetailedErrorCode
DetailedErrorCode
Name | Typ | Description |
---|---|---|
DataImportFailed |
string |
Dataimporten misslyckades. |
DeleteNotAllowed |
string |
Ta bort tillåts inte. |
DeployNotAllowed |
string |
Distribution tillåts inte. |
DeployingFailedModel |
string |
Distributionen av en misslyckad modell. |
EmptyRequest |
string |
Tom begäran. |
EndpointCannotBeDefault |
string |
Slutpunkten kan inte vara standard. |
EndpointNotUpdatable |
string |
Slutpunkten kan inte uppdateras. |
EndpointWithoutLogging |
string |
Slutpunkt utan loggning. |
ExceededNumberOfRecordingsUris |
string |
Överskred antalet inspelningar uris. |
FailedDataset |
string |
Datauppsättningen misslyckades. |
Forbidden |
string |
Förbjudet. |
InUseViolation |
string |
Vid användningsöverträdelse. |
InaccessibleCustomerStorage |
string |
Otillgänglig kundlagring. |
InvalidAdaptationMapping |
string |
Ogiltig anpassningsmappning. |
InvalidBaseModel |
string |
Ogiltig basmodell. |
InvalidCallbackUri |
string |
Ogiltig återanrops-uri. |
InvalidCollection |
string |
Ogiltig samling. |
InvalidDataset |
string |
Ogiltig datauppsättning. |
InvalidDocument |
string |
Ogiltigt dokument. |
InvalidDocumentBatch |
string |
Ogiltig dokumentbatch. |
InvalidLocale |
string |
Ogiltigt språk. |
InvalidLogDate |
string |
Ogiltigt loggdatum. |
InvalidLogEndTime |
string |
Ogiltig loggsluttid. |
InvalidLogId |
string |
Ogiltigt logg-ID. |
InvalidLogStartTime |
string |
Ogiltig starttid för loggen. |
InvalidModel |
string |
Ogiltig modell. |
InvalidModelUri |
string |
Ogiltig modell-URI. |
InvalidParameter |
string |
Ogiltig parameter. |
InvalidParameterValue |
string |
Ogiltigt parametervärde. |
InvalidPayload |
string |
Ogiltig nyttolast. |
InvalidPermissions |
string |
Ogiltiga behörigheter. |
InvalidPrerequisite |
string |
Ogiltig förutsättning. |
InvalidProductId |
string |
Ogiltigt produkt-ID. |
InvalidProject |
string |
Ogiltigt projekt. |
InvalidProjectKind |
string |
Ogiltig projekttyp. |
InvalidRecordingsUri |
string |
Ogiltig inspelnings-URI. |
InvalidRequestBodyFormat |
string |
Ogiltigt brödtextformat för begäran. |
InvalidSasValidityDuration |
string |
Ogiltig varaktighet för sas-giltighet. |
InvalidSkipTokenForLogs |
string |
Ogiltig hopptoken för loggar. |
InvalidSourceAzureResourceId |
string |
Ogiltigt käll-Azure-resurs-ID. |
InvalidSubscription |
string |
Ogiltig prenumeration. |
InvalidTest |
string |
Ogiltigt test. |
InvalidTimeToLive |
string |
Ogiltig tid att leva. |
InvalidTopForLogs |
string |
Ogiltig överkant för loggar. |
InvalidTranscription |
string |
Ogiltig transkription. |
InvalidWebHookEventKind |
string |
Ogiltig webbhookhändelsetyp. |
MissingInputRecords |
string |
Indataposter saknas. |
ModelCopyOperationExists |
string |
Modellkopieringsåtgärden finns. |
ModelDeploymentNotCompleteState |
string |
Modelldistributionen är inte fullständigt. |
ModelDeprecated |
string |
Modellen är inaktuell. |
ModelExists |
string |
Modellen finns. |
ModelMismatch |
string |
Modellmatchningsfel. |
ModelNotDeployable |
string |
Modellen kan inte distribueras. |
ModelVersionIncorrect |
string |
Modellversionen är felaktig. |
NoUtf8WithBom |
string |
Ingen utf8 med bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Endast en av URL:erna eller containern eller datauppsättningen. |
ProjectGenderMismatch |
string |
Matchningsfel för projektkön. |
QuotaViolation |
string |
Kvotöverträdelse. |
SingleDefaultEndpoint |
string |
Enskild standardslutpunkt. |
SkuLimitsExist |
string |
Det finns SKU-gränser. |
SubscriptionNotFound |
string |
Det går inte att hitta prenumerationen. |
UnexpectedError |
string |
Oväntat fel. |
UnsupportedClassBasedAdaptation |
string |
Klassbaserad anpassning stöds inte. |
UnsupportedDelta |
string |
Delta stöds inte. |
UnsupportedDynamicConfiguration |
string |
Dynamisk konfiguration stöds inte. |
UnsupportedFilter |
string |
Filter som inte stöds. |
UnsupportedLanguageCode |
string |
Språkkod som inte stöds. |
UnsupportedOrderBy |
string |
Order som inte stöds av. |
UnsupportedPagination |
string |
Sidnumrering stöds inte. |
UnsupportedTimeRange |
string |
Tidsintervallet stöds inte. |
EntityError
EntityError
Name | Typ | Description |
---|---|---|
code |
string |
Koden för det här felet. |
message |
string |
Meddelandet för det här felet. |
EntityReference
EntityReference
Name | Typ | Description |
---|---|---|
self |
string |
Platsen för den refererade entiteten. |
Error
Fel
Name | Typ | Description |
---|---|---|
code |
Felkod |
|
details |
Error[] |
Ytterligare stödjande information om fel- och/eller förväntade principer. |
innerError |
InnerError |
|
message |
string |
Felmeddelande på hög nivå. |
target |
string |
Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt. |
ErrorCode
Felkod
Name | Typ | Description |
---|---|---|
Conflict |
string |
Representerar konfliktfelkoden. |
Forbidden |
string |
Representerar den otillåtna felkoden. |
InternalCommunicationFailed |
string |
Det gick inte att representera felkoden för intern kommunikation. |
InternalServerError |
string |
Representerar felkoden för den interna servern. |
InvalidArgument |
string |
Representerar den ogiltiga argumentfelkoden. |
InvalidRequest |
string |
Representerar felkoden för ogiltig begäran. |
NotAllowed |
string |
Representerar den felkod som inte tillåts. |
NotFound |
string |
Representerar felkoden som inte hittades. |
PipelineError |
string |
Representerar felkoden för pipelinefel. |
ServiceUnavailable |
string |
Representerar felkoden för tjänsten som inte är tillgänglig. |
TooManyRequests |
string |
Representerar felkoden för många begäranden. |
Unauthorized |
string |
Representerar den otillåtna felkoden. |
UnprocessableEntity |
string |
Representerar felkoden för entiteten som inte kan bearbetas. |
UnsupportedMediaType |
string |
Representerar felkoden för medietypen som inte stöds. |
InnerError
InnerError
Name | Typ | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Ytterligare stödjande information om fel- och/eller förväntade principer. |
innerError |
InnerError |
|
message |
string |
Felmeddelande på hög nivå. |
target |
string |
Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt. |
OutputFormatType
OutputFormatType
Name | Typ | Description |
---|---|---|
Display |
string |
Modellen stöder utdata eller slutpunkter för visningsformateringstranskriptioner. |
Lexical |
string |
Modellen tillhandahåller transkriptionsutdata utan formatering. |
Status
Status
Name | Typ | Description |
---|---|---|
Failed |
string |
Den långvariga åtgärden misslyckades. |
NotStarted |
string |
Den långvariga åtgärden har ännu inte startats. |
Running |
string |
Den tidskrävande åtgärden bearbetas för närvarande. |
Succeeded |
string |
Den långvariga åtgärden har slutförts. |