Create Model - Create Model
Erstellt ein neues Modell.
POST {Endpoint}/speechtotext/v3.0/models
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://westus.api.cognitive.microsoft.com |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
displayName | True |
string |
Der Anzeigename des Objekts. |
locale | True |
string |
Das Gebietsschema der enthaltenen Daten. |
baseModel |
EntityReference |
||
customProperties |
object |
Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge 256 Zeichen und die Anzahl der zulässigen Einträge beträgt 10. |
|
datasets |
Datasets, die für die Anpassung verwendet werden. |
||
description |
string |
Die Beschreibung des -Objekts. |
|
links |
ModelLinks |
||
project |
EntityReference |
||
properties |
ModelProperties |
||
text |
string |
Der Text, der zum Anpassen dieses Sprachmodells verwendet wird. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
201 Created |
Die Antwort enthält Informationen über die Entität als Nutzlast und ihren Speicherort als Header. Headers Location: string |
|
Other Status Codes |
Ein Fehler ist aufgetreten. |
Sicherheit
Ocp-Apim-Subscription-Key
Geben Sie hier Ihren Cognitive Services-Kontoschlüssel an.
Type:
apiKey
In:
header
Authorization
Stellen Sie ein Zugriffstoken aus dem JWT bereit, das vom STS dieser Region zurückgegeben wird. Fügen Sie dem Token den Verwaltungsbereich hinzu, indem Sie der STS-URL die folgende Abfragezeichenfolge hinzufügen: ?scope=speechservicesmanagement
Type:
apiKey
In:
header
Beispiele
Create a model
Sample Request
POST https://westus.api.cognitive.microsoft.com//speechtotext/v3.0/models
{
"baseModel": {
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
},
"datasets": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
}
],
"locale": "en-US",
"displayName": "Model with acoustic and language datasets"
}
Sample Response
Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/827712a5-f942-4997-91c3-7c6cde35600b
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/827712a5-f942-4997-91c3-7c6cde35600b",
"baseModel": {
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
},
"datasets": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
}
],
"links": {
"manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
"copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/827712a5-f942-4997-91c3-7c6cde35600b/copy"
},
"properties": {
"deprecationDates": {
"adaptationDateTime": "2022-11-04T00:00:00Z",
"transcriptionDateTime": "2023-05-04T00:00:00Z"
}
},
"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"
}
Definitionen
Name | Beschreibung |
---|---|
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Fehler |
Error |
ErrorCode |
Inner |
InnerError |
Model |
Modell |
Model |
ModelDeprecationDates |
Model |
ModelLinks |
Model |
ModelProperties |
Status |
Status |
DetailedErrorCode
DetailedErrorCode
Name | Typ | Beschreibung |
---|---|---|
DataImportFailed |
string |
Fehler beim Datenimport. |
DeleteNotAllowed |
string |
Löschen nicht zulässig. |
DeployNotAllowed |
string |
Bereitstellen ist nicht zulässig. |
DeployingFailedModel |
string |
Bereitstellen eines fehlerhaften Modells. |
EmptyRequest |
string |
Leere Anforderung. |
EndpointCannotBeDefault |
string |
Der Endpunkt kann nicht standardmäßig sein. |
EndpointNotUpdatable |
string |
Endpunkt nicht aktualisierbar. |
EndpointWithoutLogging |
string |
Endpunkt ohne Protokollierung. |
ExceededNumberOfRecordingsUris |
string |
Die Anzahl der Aufzeichnungsuris wurde überschritten. |
FailedDataset |
string |
Fehlgeschlagenes Dataset. |
Forbidden |
string |
Unzulässig. |
InUseViolation |
string |
Bei verwendungsverstößen. |
InaccessibleCustomerStorage |
string |
Nicht zugänglicher Kundenspeicher. |
InvalidAdaptationMapping |
string |
Ungültige Anpassungszuordnung. |
InvalidBaseModel |
string |
Ungültiges Basismodell. |
InvalidCallbackUri |
string |
Ungültiger Rückruf-URI. |
InvalidCollection |
string |
Ungültige Auflistung. |
InvalidDataset |
string |
Ungültiges Dataset. |
InvalidDocument |
string |
Ungültiges Dokument. |
InvalidDocumentBatch |
string |
Ungültiger Dokumentbatch. |
InvalidLocale |
string |
Ungültiges Gebietsschema. |
InvalidLogDate |
string |
Ungültiges Protokolldatum. |
InvalidLogEndTime |
string |
Ungültige Protokollendzeit. |
InvalidLogId |
string |
Ungültige Protokoll-ID. |
InvalidLogStartTime |
string |
Ungültige Protokollstartzeit. |
InvalidModel |
string |
Ungültiges Modell. |
InvalidModelUri |
string |
Ungültiger Modell-URI. |
InvalidParameter |
string |
Ungültiger Parameter. |
InvalidParameterValue |
string |
Ungültiger Parameterwert. |
InvalidPayload |
string |
Ungültige Nutzlast. |
InvalidPermissions |
string |
Ungültige Berechtigungen. |
InvalidPrerequisite |
string |
Ungültige Voraussetzung. |
InvalidProductId |
string |
Ungültige Produkt-ID. |
InvalidProject |
string |
Ungültiges Projekt. |
InvalidProjectKind |
string |
Ungültige Projektart. |
InvalidRecordingsUri |
string |
Ungültiger Aufzeichnungs-URI. |
InvalidRequestBodyFormat |
string |
Ungültiges Anforderungstextformat. |
InvalidSasValidityDuration |
string |
Ungültige sas-Gültigkeitsdauer. |
InvalidSkipTokenForLogs |
string |
Ungültiges Überspringen von Token für Protokolle. |
InvalidSubscription |
string |
Ungültiges Abonnement. |
InvalidTest |
string |
Ungültiger Test. |
InvalidTimeToLive |
string |
Ungültige Gültigkeitsdauer. |
InvalidTopForLogs |
string |
Ungültiger Oberteil für Protokolle. |
InvalidTranscription |
string |
Ungültige Transkription. |
InvalidWebHookEventKind |
string |
Ungültige Web hook-Ereignisart. |
MissingInputRecords |
string |
Fehlende Eingabedatensätze. |
ModelDeploymentNotCompleteState |
string |
Der Zustand der Modellbereitstellung ist nicht abgeschlossen. |
ModelDeprecated |
string |
Das Modell ist veraltet. |
ModelExists |
string |
Das Modell ist vorhanden. |
ModelMismatch |
string |
Modellkonflikt. |
ModelNotDeployable |
string |
Das Modell kann nicht bereitgestellt werden. |
ModelVersionIncorrect |
string |
Modellversion falsch. |
NoUtf8WithBom |
string |
Kein utf8 mit Bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Nur eine der URLs, container oder datasets. |
ProjectGenderMismatch |
string |
Projekt gender mismatch. |
QuotaViolation |
string |
Kontingentverletzung. |
SingleDefaultEndpoint |
string |
Einzelner Standardendpunkt. |
SkuLimitsExist |
string |
Sku-Grenzwerte sind vorhanden. |
SubscriptionNotFound |
string |
Abonnement wurde nicht gefunden. |
UnexpectedError |
string |
Unerwarteter Fehler. |
UnsupportedClassBasedAdaptation |
string |
Nicht unterstützte klassenbasierte Anpassung. |
UnsupportedDelta |
string |
Nicht unterstütztes Delta. |
UnsupportedDynamicConfiguration |
string |
Nicht unterstützte dynamische Konfiguration. |
UnsupportedFilter |
string |
Nicht unterstützter Filter. |
UnsupportedLanguageCode |
string |
Nicht unterstützter Sprachcode. |
UnsupportedOrderBy |
string |
Nicht unterstützte Reihenfolge nach. |
UnsupportedPagination |
string |
Nicht unterstützte Paginierung. |
UnsupportedTimeRange |
string |
Nicht unterstützte Zeitbereiche. |
EntityError
EntityError
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Code dieses Fehlers. |
message |
string |
Die Meldung für diesen Fehler. |
EntityReference
EntityReference
Name | Typ | Beschreibung |
---|---|---|
self |
string |
Der Speicherort der Entität, auf die verwiesen wird. |
Error
Fehler
Name | Typ | Beschreibung |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien. |
innerError |
InnerError |
|
message |
string |
Allgemeine Fehlermeldung. |
target |
string |
Die Ursache des Fehlers. Dies wäre z. B. „Dokumente“ oder „Dokument-ID“ im Falle eines ungültigen Dokuments. |
ErrorCode
ErrorCode
Name | Typ | Beschreibung |
---|---|---|
Conflict |
string |
Stellt den Konfliktfehlercode dar. |
Forbidden |
string |
Stellt den unzulässigen Fehlercode dar. |
InternalCommunicationFailed |
string |
Stellt den Fehlercode für interne Kommunikationsfehler dar. |
InternalServerError |
string |
Stellt den Fehlercode des internen Servers dar. |
InvalidArgument |
string |
Stellt den Fehlercode des ungültigen Arguments dar. |
InvalidRequest |
string |
Stellt den ungültigen Anforderungsfehlercode dar. |
NotAllowed |
string |
Stellt den nicht zulässigen Fehlercode dar. |
NotFound |
string |
Stellt den Fehlercode nicht gefunden dar. |
PipelineError |
string |
Stellt den Fehlercode für die Pipeline dar. |
ServiceUnavailable |
string |
Stellt den Nicht verfügbaren Fehlercode des Diensts dar. |
TooManyRequests |
string |
Stellt den Fehlercode für zu viele Anforderungen dar. |
Unauthorized |
string |
Stellt den nicht autorisierten Fehlercode dar. |
UnprocessableEntity |
string |
Stellt den Fehlercode für nicht bearbeitbare Entitäten dar. |
UnsupportedMediaType |
string |
Stellt den fehlercode für den nicht unterstützten Medientyp dar. |
InnerError
InnerError
Name | Typ | Beschreibung |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien. |
innerError |
InnerError |
|
message |
string |
Allgemeine Fehlermeldung. |
target |
string |
Die Ursache des Fehlers. Dies wäre z. B. „Dokumente“ oder „Dokument-ID“ im Falle eines ungültigen Dokuments. |
Model
Modell
Name | Typ | Beschreibung |
---|---|---|
baseModel |
EntityReference |
|
createdDateTime |
string |
Der Zeitstempel, zu dem das Objekt erstellt wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-TTThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge beträgt 256 Zeichen und die Anzahl der zulässigen Einträge beträgt 10. |
datasets |
Datasets, die für die Anpassung verwendet werden. |
|
description |
string |
Die Beschreibung des -Objekts. |
displayName |
string |
Der Anzeigename des Objekts. |
lastActionDateTime |
string |
Der Zeitstempel, bei dem der aktuelle status eingegeben wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-TTThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
ModelLinks |
|
locale |
string |
Das Gebietsschema der enthaltenen Daten. |
project |
EntityReference |
|
properties |
ModelProperties |
|
self |
string |
Der Speicherort dieser Entität. |
status |
Status |
|
text |
string |
Der Text, der zum Anpassen dieses Sprachmodells verwendet wird. |
ModelDeprecationDates
ModelDeprecationDates
Name | Typ | Beschreibung |
---|---|---|
adaptationDateTime |
string |
|
transcriptionDateTime |
string |
ModelLinks
ModelLinks
Name | Typ | Beschreibung |
---|---|---|
copyTo |
string |
Der Speicherort der Modellkopieraktion. |
manifest |
string |
Der Speicherort zum Abrufen eines Manifests für dieses Modell, das im lokalen Container verwendet werden soll. |
ModelProperties
ModelProperties
Name | Typ | Beschreibung |
---|---|---|
deprecationDates |
ModelDeprecationDates |
|
string |
Die E-Mail-Adresse, an die E-Mail-Benachrichtigungen gesendet werden sollen, falls der Vorgang abgeschlossen ist. Der Wert wird entfernt, nachdem die E-Mail erfolgreich gesendet wurde. |
|
error |
EntityError |
Status
Status
Name | Typ | Beschreibung |
---|---|---|
Failed |
string |
Der Vorgang mit langer Ausführungsdauer ist fehlgeschlagen. |
NotStarted |
string |
Der lang andauernde Vorgang wurde noch nicht gestartet. |
Running |
string |
Der Vorgang mit langer Ausführungszeit wird derzeit verarbeitet. |
Succeeded |
string |
Der lang andauernde Vorgang wurde erfolgreich abgeschlossen. |