Training Sets - Upload Data

Služba:

Azure AI Services

Verze rozhraní API:

2024-02-01-preview

Nahraje data do zadané trénovací sady.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	ID prostředku. Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Sem zadejte svůj klíč prostředku služby Speech.
Operation-Id		string	ID monitorování stavu operace Pokud hlavička Operation-Id odpovídá existující operaci a požadavek není shodný s předchozím požadavkem, selže s chybou 400 Chybný požadavek. Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Text požadavku

Name	Vyžadováno	Typ	Description
audios	True	AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Druh datové sady
description		string	Volitelný popis této datové sady
displayName		string	Název této datové sady.
scripts		AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Odpovědi

Name	Typ	Description
202 Accepted		Přijato Hlavičky Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Došlo k chybě. Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Sem zadejte svůj klíč prostředku služby Speech.

Typ: apiKey
V: header

Příklady

Upload data to a training set

Ukázkový požadavek

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"
    ]
  }
}

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Objekt datové sady
DatasetKind	Druh datové sady
Error	Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.
ErrorCode	Kód chyby nejvyšší úrovně
ErrorResponse	Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).

AzureBlobContentSource

Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Description
containerUrl	string	Adresa URL kontejneru Azure Blob Storage se SAS Potřebujete oprávnění ke čtení i výpisu.
extensions	string[]	Přípony názvů souborů.
prefix	string	Předpona názvu objektu blob.

Dataset

Objekt datové sady

Name	Typ	Description
audios	AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Volitelný popis této datové sady
displayName	string	Název této datové sady.
kind	DatasetKind	Druh datové sady
scripts	AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Druh datové sady

Name	Typ	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

Name	Typ	Description
code	ErrorCode	Kód chyby nejvyšší úrovně
details	Error[]	Další podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innererror	InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Chybová zpráva nejvyšší úrovně
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "model" nebo "id modelu".

ErrorCode

Kód chyby nejvyšší úrovně

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

ErrorResponse

Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Description
error	Error	Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).

Name	Typ	Description
code	string	Podrobný kód chyby, který vám pomůže s diagnostikou.
innererror	InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Podrobná chybová zpráva
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "model" nebo "id modelu".