Training Sets - Upload Data

Tjänst:

Azure AI Services

API-version:

2024-02-01-preview

Laddar upp data till den angivna träningsuppsättningen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Resursens ID. Reguljärt uttrycksmönster: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Ange din Speech-resursnyckel här.
Operation-Id		string	ID för statusövervakaren för åtgärden. Om Operation-Id-huvudet matchar en befintlig åtgärd och begäran inte är identisk med den tidigare begäran misslyckas den med en 400 Felaktig begäran. Reguljärt uttrycksmönster: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Begärandetext

Name	Obligatorisk	Typ	Description
audios	True	AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Typ av datauppsättning
description		string	Valfri beskrivning av den här datauppsättningen.
displayName		string	Namnet på den här datauppsättningen.
scripts		AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Svar

Name	Typ	Description
202 Accepted		Har godkänts Sidhuvuden Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ett fel inträffade. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Ange din Speech-resursnyckel här.

Typ: apiKey
I: header

Exempel

Upload data to a training set

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Datauppsättningsobjekt
DatasetKind	Typ av datauppsättning
Error	Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.
ErrorCode	Felkod på den översta nivån
ErrorResponse	Felsvaret följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).

AzureBlobContentSource

Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Description
containerUrl	string	Url för Azure Blob Storage-container med SAS. Behöver både läs- och listbehörigheter.
extensions	string[]	Filnamnstillägg.
prefix	string	Prefix för blobnamn.

Dataset

Datauppsättningsobjekt

Name	Typ	Description
audios	AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Valfri beskrivning av den här datauppsättningen.
displayName	string	Namnet på den här datauppsättningen.
kind	DatasetKind	Typ av datauppsättning
scripts	AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Typ av datauppsättning

Name	Typ	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

Name	Typ	Description
code	ErrorCode	Felkod på den översta nivån
details	Error[]	Ytterligare stödjande information om fel- och/eller förväntade principer.
innererror	InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Felmeddelande på den översta nivån.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" om modellen är ogiltig.

ErrorCode

Felkod på den översta nivån

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

ErrorResponse

Felsvaret följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Description
error	Error	Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

InnerError

Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).

Name	Typ	Description
code	string	Detaljerad felkod för att hjälpa till med diagnostiken.
innererror	InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Detaljerat felmeddelande.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" om modellen är ogiltig.