Projects - List Models
Lekéri a megadott projekt modelllistáját.
GET {endpoint}/speechtotext/v3.2-preview.2/projects/{id}/models
GET {endpoint}/speechtotext/v3.2-preview.2/projects/{id}/models?skip={skip}&top={top}&filter={filter}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com). |
id
|
path | True |
string uuid |
A projekt azonosítója. |
filter
|
query |
string |
Szűrőkifejezés az elérhető modellek egy részhalmazának kiválasztásához.
|
|
skip
|
query |
integer int32 |
Kihagyandó adathalmazok száma. |
|
top
|
query |
integer int32 |
A kihagyás után belefoglalandó adathalmazok száma. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK Headers Retry-After: integer |
|
Other Status Codes |
Hiba történt. |
Biztonság
Ocp-Apim-Subscription-Key
Itt adhatja meg a Cognitive Services-fiókkulcsot.
Type:
apiKey
In:
header
Authorization
Adjon meg egy hozzáférési jogkivonatot a régió STS által visszaadott JWT-ből. Győződjön meg arról, hogy hozzáadja a felügyeleti hatókört a jogkivonathoz. Ehhez adja hozzá a következő lekérdezési sztringet az STS URL-címéhez: ?scope=speechservicesmanagement
Type:
apiKey
In:
header
Példák
Get all models
Sample Request
GET {endpoint}/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models?skip=0&top=2&filter=status%20eq%20'Running'
Sample Response
{
"values": [
{
"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"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/a04e77e6-2009-462c-8d1c-65d718ee4b7b",
"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/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
}
],
"links": {
"manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/a04e77e6-2009-462c-8d1c-65d718ee4b7b",
"copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/a04e77e6-2009-462c-8d1c-65d718ee4b7b:copyto",
"copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/a04e77e6-2009-462c-8d1c-65d718ee4b7b:copy",
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/a04e77e6-2009-462c-8d1c-65d718ee4b7b/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": "Acoustic model",
"description": "Example for an acoustic model"
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models?skip=2&top=2&filter=status%20eq%20'Running'"
}
Definíciók
Name | Description |
---|---|
Custom |
CustomModel |
Custom |
CustomModelDeprecationDates |
Custom |
CustomModelFeatures |
Custom |
CustomModelLinks |
Custom |
CustomModelProperties |
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Hiba |
Error |
ErrorCode |
Inner |
InnerError |
Output |
OutputFormatType |
Paginated |
LapszámozottCustomModels |
Status |
Állapot |
CustomModel
CustomModel
Name | Típus | Description |
---|---|---|
baseModel |
EntityReference |
|
createdDateTime |
string |
Az objektum létrehozásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("ÉÉÉÉÉ-HH-NNH:mm:ssZ", lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
Az entitás egyéni tulajdonságai. A maximális megengedett kulcshossz 64 karakter, a megengedett érték maximális hossza 256 karakter, az engedélyezett bejegyzések száma pedig 10. |
datasets |
Az adaptációhoz használt adathalmazok. |
|
description |
string |
Az objektum leírása. |
displayName |
string |
Az objektum megjelenítendő neve. |
lastActionDateTime |
string |
Az aktuális állapot megadásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("ÉÉÉÉÉ-HH-NNH:mm:ssZ", lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
CustomModelLinks |
|
locale |
string |
A tartalmazott adatok területi beállítása. |
project |
EntityReference |
|
properties |
CustomModelProperties |
|
self |
string |
Az entitás helye. |
status |
Állapot |
|
text |
string |
A nyelvi modell adaptálásához használt szöveg. |
CustomModelDeprecationDates
CustomModelDeprecationDates
Name | Típus | Description |
---|---|---|
transcriptionDateTime |
string |
Az átírás elavulttá válásának dátuma. |
CustomModelFeatures
CustomModelFeatures
Name | Típus | Description |
---|---|---|
supportedOutputFormats |
Támogatott kimeneti formátumok. |
|
supportsEndpoints |
boolean |
Egy érték, amely azt jelzi, hogy támogatott-e végpontok létrehozása élő átíráshoz. |
supportsTranscriptions |
boolean |
Egy érték, amely azt jelzi, hogy támogatott-e a kötegelt átírás. |
supportsTranscriptionsOnSpeechContainers |
boolean |
Egy érték, amely azt jelzi, hogy ez a modell használható-e a beszédtároló átírásához. Ez a funkció meglévő modelleken is hozzáadható, ha használhatóvá válik a beszédtárolóban. |
CustomModelLinks
CustomModelLinks
Name | Típus | Description |
---|---|---|
copy |
string |
A modell másolási műveletének helye. További részletekért lásd: "Models_Copy" művelet. |
copyTo |
string |
Az elavult modell másolási műveletének helye. További részletekért lásd: "Models_CopyTo" művelet. |
files |
string |
Az entitás összes fájljának lekérésének helye. További részletekért lásd: "Models_ListFiles" művelet. |
manifest |
string |
A modell jegyzékfájljának lekérésének helye a helyszíni tárolóban. További részletekért lásd: "Models_GetCustomModelManifest" művelet. |
CustomModelProperties
CustomModelProperties
Name | Típus | Description |
---|---|---|
customModelWeightPercent |
integer |
Az egyéni modell súlya 1 (1% egyéni és 99%-os alapmodell) és 100 (100% egyéni modell és 0% alapmodell) között. Ha ez a tulajdonság nincs beállítva, a szolgáltatás kiválaszt egy megfelelő értéket (lekéri a modellt a kiválasztott súly lekéréséhez). Kezdje a tulajdonság használata nélkül. Ha szükséges, válasszon egy nagyobb (vagy kisebb) súlyt az egyéni modell hatásának növeléséhez (vagy csökkentéséhez). |
deprecationDates |
CustomModelDeprecationDates |
|
string |
Az e-mail-értesítések küldéséhez használt e-mail-cím, ha a művelet befejeződik. Az érték az e-mail sikeres elküldése után törlődik. |
|
error |
EntityError |
|
features |
CustomModelFeatures |
DetailedErrorCode
DetailedErrorCode
Name | Típus | Description |
---|---|---|
DataImportFailed |
string |
Az adatimportálás sikertelen volt. |
DeleteNotAllowed |
string |
A törlés nem engedélyezett. |
DeployNotAllowed |
string |
Az üzembe helyezés nem engedélyezett. |
DeployingFailedModel |
string |
Sikertelen modell üzembe helyezése. |
EmptyRequest |
string |
Üres kérelem. |
EndpointCannotBeDefault |
string |
A végpont nem lehet alapértelmezett. |
EndpointNotUpdatable |
string |
A végpont nem frissíthető. |
EndpointWithoutLogging |
string |
Végpont naplózás nélkül. |
ExceededNumberOfRecordingsUris |
string |
Túllépte a felvétel URI-jainak számát. |
FailedDataset |
string |
Nem sikerült az adathalmaz. |
Forbidden |
string |
Tiltott. |
InUseViolation |
string |
Használaton belüli szabálysértés. |
InaccessibleCustomerStorage |
string |
Nem érhető el az ügyféltároló. |
InvalidAdaptationMapping |
string |
Érvénytelen adaptációs leképezés. |
InvalidBaseModel |
string |
Érvénytelen alapmodell. |
InvalidCallbackUri |
string |
Érvénytelen visszahívási URI. |
InvalidCollection |
string |
Érvénytelen gyűjtemény. |
InvalidDataset |
string |
Érvénytelen adatkészlet. |
InvalidDocument |
string |
Érvénytelen dokumentum. |
InvalidDocumentBatch |
string |
Érvénytelen dokumentumköteg. |
InvalidLocale |
string |
Érvénytelen területi beállítás. |
InvalidLogDate |
string |
Érvénytelen naplódátum. |
InvalidLogEndTime |
string |
Érvénytelen naplóvégzési idő. |
InvalidLogId |
string |
Érvénytelen naplóazonosító. |
InvalidLogStartTime |
string |
Érvénytelen a napló kezdési időpontja. |
InvalidModel |
string |
Érvénytelen modell. |
InvalidModelUri |
string |
Érvénytelen modell URI-ja. |
InvalidParameter |
string |
Érvénytelen paraméter. |
InvalidParameterValue |
string |
Érvénytelen paraméterérték. |
InvalidPayload |
string |
Érvénytelen hasznos adat. |
InvalidPermissions |
string |
Érvénytelen engedélyek. |
InvalidPrerequisite |
string |
Érvénytelen előfeltétel. |
InvalidProductId |
string |
Érvénytelen termékazonosító. |
InvalidProject |
string |
Érvénytelen projekt. |
InvalidProjectKind |
string |
Érvénytelen projekttípus. |
InvalidRecordingsUri |
string |
Érvénytelen felvételek URI-ja. |
InvalidRequestBodyFormat |
string |
Érvénytelen a kérelem törzsének formátuma. |
InvalidSasValidityDuration |
string |
Érvénytelen sas-érvényességi időtartam. |
InvalidSkipTokenForLogs |
string |
Érvénytelen kihagyó jogkivonat a naplókhoz. |
InvalidSourceAzureResourceId |
string |
Érvénytelen forrás Azure-erőforrás-azonosító. |
InvalidSubscription |
string |
Érvénytelen előfizetés. |
InvalidTest |
string |
Érvénytelen teszt. |
InvalidTimeToLive |
string |
Érvénytelen élettartam. |
InvalidTopForLogs |
string |
A naplók felső része érvénytelen. |
InvalidTranscription |
string |
Érvénytelen átírás. |
InvalidWebHookEventKind |
string |
Érvénytelen webhookesemény-típus. |
MissingInputRecords |
string |
Hiányzó bemeneti rekordok. |
ModelCopyOperationExists |
string |
Létezik modellmásolási művelet. |
ModelDeploymentNotCompleteState |
string |
A modell üzembe helyezése nem fejeződött be. |
ModelDeprecated |
string |
A modell elavult. |
ModelExists |
string |
A modell létezik. |
ModelMismatch |
string |
Modelleltérés. |
ModelNotDeployable |
string |
A modell nem helyezhető üzembe. |
ModelVersionIncorrect |
string |
A modell verziója helytelen. |
NoUtf8WithBom |
string |
Nincs utf8 a bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Csak egy URL-cím, tároló vagy adatkészlet. |
ProjectGenderMismatch |
string |
A projekt neme nem egyezik. |
QuotaViolation |
string |
Kvóta megsértése. |
SingleDefaultEndpoint |
string |
Egyetlen alapértelmezett végpont. |
SkuLimitsExist |
string |
A termékváltozatra vonatkozó korlátozások léteznek. |
SubscriptionNotFound |
string |
Az előfizetés nem található. |
UnexpectedError |
string |
Váratlan hiba. |
UnsupportedClassBasedAdaptation |
string |
Nem támogatott osztályalapú adaptáció. |
UnsupportedDelta |
string |
Nem támogatott változás. |
UnsupportedDynamicConfiguration |
string |
Nem támogatott dinamikus konfiguráció. |
UnsupportedFilter |
string |
Nem támogatott szűrő. |
UnsupportedLanguageCode |
string |
Nem támogatott nyelvi kód. |
UnsupportedOrderBy |
string |
Nem támogatott sorrend szerint. |
UnsupportedPagination |
string |
Nem támogatott lapozás. |
UnsupportedTimeRange |
string |
Nem támogatott időtartomány. |
EntityError
EntityError
Name | Típus | Description |
---|---|---|
code |
string |
A hiba kódja. |
message |
string |
A hiba üzenete. |
EntityReference
EntityReference
Name | Típus | Description |
---|---|---|
self |
string |
A hivatkozott entitás helye. |
Error
Hiba
Name | Típus | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
ErrorCode
ErrorCode
Name | Típus | Description |
---|---|---|
Conflict |
string |
Az ütközési hibakódnak megfelelő. |
Forbidden |
string |
A tiltott hibakódot jelöli. |
InternalCommunicationFailed |
string |
A belső kommunikáció hibakódját jelképező hibakód. |
InternalServerError |
string |
A belső kiszolgáló hibakódját jelöli. |
InvalidArgument |
string |
Az érvénytelen argumentum hibakódját jelöli. |
InvalidRequest |
string |
Az érvénytelen kérelem hibakódját jelöli. |
NotAllowed |
string |
A nem engedélyezett hibakódot jelöli. |
NotFound |
string |
A nem található hibakódot jelöli. |
PipelineError |
string |
A folyamat hibakódját jelöli. |
ServiceUnavailable |
string |
A szolgáltatás nem érhető el hibakódját jelöli. |
TooManyRequests |
string |
A túl sok kérés hibakódját jelöli. |
Unauthorized |
string |
A jogosulatlan hibakódot jelöli. |
UnprocessableEntity |
string |
A feldolgozhatatlan entitás hibakódját jelöli. |
UnsupportedMediaType |
string |
A nem támogatott médiatípus hibakódját jelöli. |
InnerError
InnerError
Name | Típus | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
OutputFormatType
OutputFormatType
Name | Típus | Description |
---|---|---|
Display |
string |
A modell támogatja a megjelenítési formázás átiratainak kimenetét vagy végpontokat. |
Lexical |
string |
A modell formázás nélkül biztosítja az átírás kimenetét. |
PaginatedCustomModels
LapszámozottCustomModels
Name | Típus | Description |
---|---|---|
@nextLink |
string |
Hivatkozás a lapszámozott eredmények következő készletére, ha több entitás érhető el; egyébként null értékű. |
values |
A "skip" és a "top" átadott lekérdezési paraméterek vagy az alapértelmezett értékek által korlátozott entitások listája. Ha egy listát lapszámozással és entitások párhuzamos törlésével iterál, egyes entitások kimaradnak az eredményekből. Javasoljuk, hogy hozzon létre egy listát az ügyfélen, és törölje a teljes lista lekérése után. |
Status
Állapot
Name | Típus | Description |
---|---|---|
Failed |
string |
A hosszú ideig futó művelet meghiúsult. |
NotStarted |
string |
A hosszú ideig futó művelet még nem indult el. |
Running |
string |
A hosszú ideig futó művelet feldolgozása folyamatban van. |
Succeeded |
string |
A hosszú ideig futó művelet sikeresen befejeződött. |