Training Sets - Upload Data

Szolgáltatás:: Azure AI Services

API-verzió:: 2026-01-01

Feltölti az adatokat a megadott képzési halmazba.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://eastus.api.cognitive.microsoft.com).
id	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Az erőforrás azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Az operáció állapotmonitorjának azonosítója. Ha a Operation-Id fejléc egyezik egy meglévő művelettel, és a kérés nem egyezik meg az előző kéréssel, akkor egy 400 rossz kéréssel megbukik.

Kérelem törzse

Név	Kötelező	Típus	Description
audios	True	AzureBlobContentSource	Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
kind	True	DatasetKind	Adathalmaz-típus
description		string	Az adathalmaznak opcionális leírása.
displayName		string	Ennek az adatbázisnak a neve.
processAs		DatasetProcessAs	Adathalmaz-feldolgozási módszer. Ha nincs megadva, akkor az alapértelmezett feldolgozási módszert fogjuk használni.
scripts		AzureBlobContentSource	Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

Válaszok

Név	Típus	Description
202 Accepted		A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be. Fejlécek Operation-Id: string Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Név

Típus

Description

202 Accepted

A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be.

Fejlécek

Operation-Id: string
Operation-Location: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Description
https://cognitiveservices.azure.com/.default

Példák

Upload data to a training set

Mintakérelem

HTTP

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


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

Mintaválasz

Állapotkód:: 202

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

Definíciók

Név	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
AzureBlobContentSource	Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
Dataset	Adathalmaz-objektum
DatasetKind	Adathalmaz-típus
DatasetProcessAs	Adathalmaz-feldolgozási módszer. Ha nincs megadva, akkor az alapértelmezett feldolgozási módszert fogjuk használni.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Név	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

AzureBlobContentSource

Tárgy

Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Név	Típus	Description
containerUrl	string (uri)	Azure Blob Storage konténer URL-t SAS-vel. Mind olvasási, mind listázási engedélyekre van szükség.
extensions	string[]	Fájlnév-kiterjesztések.
prefix	string	Folt név előtag.

Dataset

Tárgy

Adathalmaz-objektum

Név	Típus	Description
audios	AzureBlobContentSource	Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
description	string	Az adathalmaznak opcionális leírása.
displayName	string	Ennek az adatbázisnak a neve.
kind	DatasetKind	Adathalmaz-típus
processAs	DatasetProcessAs	Adathalmaz-feldolgozási módszer. Ha nincs megadva, akkor az alapértelmezett feldolgozási módszert fogjuk használni.
scripts	AzureBlobContentSource	Azure Blob Storage content. Az alábbi példák alapján a fájlokat képviseli `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

DatasetKind

Felsorolás

Adathalmaz-típus

Érték	Description
AudioAndScript	AudioAndScript
LongAudio	LongAudio
AudioOnly	AudioOnly

DatasetProcessAs

Felsorolás

Adathalmaz-feldolgozási módszer. Ha nincs megadva, akkor az alapértelmezett feldolgozási módszert fogjuk használni.

Érték	Description
Segmented	Az alapértelmezett feldolgozási mód, amely minden támogatott nyelvvel működik.
Contextual	Egy továbbfejlesztett mód, amely megőrzi az egész hangot, hogy megőrizze a kontextuális információkat a természetesebb intonációk érdekében.