Training Sets - Upload Data

Referenz

Dienst:: Azure AI Services

API-Version:: 2024-02-01-preview

Lädt Daten in den angegebenen Trainingssatz hoch.

POST {endpoint}/customvoice/trainingsets/{id}:upload?api-version=2024-02-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://eastus.api.cognitive.microsoft.com
id	path	True	string	Die ID der Ressource. RegEx-Muster: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

endpoint

path

True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://eastus.api.cognitive.microsoft.com

path

True

string

Die ID der Ressource.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung

Ocp-Apim-Subscription-Key

True

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string	Geben Sie hier Ihren Speech-Ressourcenschlüssel an.
Operation-Id		string	ID des Statusmonitors für den Vorgang. Wenn der Operation-Id-Header mit einem vorhandenen Vorgang übereinstimmt und die Anforderung nicht mit der vorherigen Anforderung identisch ist, tritt ein Fehler mit einer 400 ungültigen Anforderung auf. RegEx-Muster: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Geben Sie hier Ihren Speech-Ressourcenschlüssel an.

Operation-Id

string

ID des Statusmonitors für den Vorgang. Wenn der Operation-Id-Header mit einem vorhandenen Vorgang übereinstimmt und die Anforderung nicht mit der vorherigen Anforderung identisch ist, tritt ein Fehler mit einer 400 ungültigen Anforderung auf.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
audios	True	AzureBlobContentSource	Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Datasetart
description		string	Optionale Beschreibung dieses Datasets.
displayName		string	Der Name dieses Datasets.
scripts		AzureBlobContentSource	Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Antworten

Name	Typ	Beschreibung
202 Accepted		Akzeptiert Header Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ein Fehler ist aufgetreten. Header x-ms-error-code: string

Name

Typ

Beschreibung

202 Accepted

Akzeptiert

Header

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Ein Fehler ist aufgetreten.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Geben Sie hier Ihren Speech-Ressourcenschlüssel an.

Typ: apiKey
In: header

Beispiele

Upload data to a training set

Beispielanforderung

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2024-02-01-preview



{
  "kind": "AudioAndScript",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

Beispiel für eine Antwort

Statuscode:: 202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

Definitionen

Name	Beschreibung
AzureBlobContentSource	Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Datasetobjekt
DatasetKind	Datasetart
Error	Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.
ErrorCode	Fehlercode auf oberster Ebene
ErrorResponse	Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist.
InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).

AzureBlobContentSource

Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Beschreibung
containerUrl	string	Azure Blob Storage-Container-URL mit SAS. Benötigen Sie Lese- und Listenberechtigungen.
extensions	string[]	Dateinamenerweiterungen.
prefix	string	Blobnamenpräfix.

Dataset

Datasetobjekt

Name	Typ	Beschreibung
audios	AzureBlobContentSource	Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Optionale Beschreibung dieses Datasets.
displayName	string	Der Name dieses Datasets.
kind	DatasetKind	Datasetart
scripts	AzureBlobContentSource	Azure Blob Storage-Inhalte. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Datasetart

Name	Typ	Beschreibung
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

Name	Typ	Beschreibung
code	ErrorCode	Fehlercode auf oberster Ebene
details	Error[]	Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien.
innererror	InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).
message	string	Fehlermeldung auf oberster Ebene.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

ErrorCode

Fehlercode auf oberster Ebene

Name	Typ	Beschreibung
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist.

Name	Typ	Beschreibung
error	Error	Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

InnerError

Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).

Name	Typ	Beschreibung
code	string	Detaillierter Fehlercode zur Unterstützung der Diagnose.
innererror	InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).
message	string	Ausführliche Fehlermeldung.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

Freigeben über

Training Sets - Upload Data

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

Beispiele

Upload data to a training set

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Zusätzliche Ressourcen