Training Sets - Upload Data

Usługa:: Azure AI Services

Wersja interfejsu API:: 2024-02-01-preview

Przekazuje dane do określonego zestawu treningowego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: 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]$	Identyfikator zasobu.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string	Tutaj podaj klucz zasobu usługi Mowa.
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identyfikator monitora stanu dla operacji. Jeśli nagłówek Operation-Id pasuje do istniejącej operacji, a żądanie nie jest identyczne z poprzednim żądaniem, zakończy się niepowodzeniem z błędem 400 Nieprawidłowe żądanie.

Treść żądania

Nazwa	Wymagane	Typ	Opis
audios	True	AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
kind	True	DatasetKind	Rodzaj zestawu danych
description		string	Opcjonalny opis tego zestawu danych.
displayName		string	Nazwa tego zestawu danych.
scripts		AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

Odpowiedzi

Nazwa	Typ	Opis
202 Accepted		Akceptowane Nagłówki Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Wystąpił błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

202 Accepted

Akceptowane

Nagłówki

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Wystąpił błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Tutaj podaj klucz zasobu usługi Mowa.

Typ: apiKey
W: header

Przykłady

Upload data to a training set

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Definicje

Nazwa	Opis
AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
Dataset	Obiekt zestawu danych
DatasetKind	Rodzaj zestawu danych
Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.
ErrorCode	Kod błędu najwyższego poziomu
ErrorResponse	Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w witrynie https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).

AzureBlobContentSource

Objekt

Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nazwa	Typ	Opis
containerUrl	string (url)	Adres URL kontenera usługi Azure Blob Storage z sygnaturą dostępu współdzielonego. Potrzebujesz uprawnień do odczytu i listy.
extensions	string[]	Rozszerzenia nazw plików.
prefix	string	Prefiks nazwy obiektu blob.

Dataset

Objekt

Obiekt zestawu danych

Nazwa	Typ	Opis
audios	AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
description	string	Opcjonalny opis tego zestawu danych.
displayName	string	Nazwa tego zestawu danych.
kind	DatasetKind	Rodzaj zestawu danych
scripts	AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

DatasetKind

Wyliczanie

Rodzaj zestawu danych

Wartość	Opis
AudioAndScript
LongAudio
AudioOnly

Error

Objekt

Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

Nazwa	Typ	Opis
code	ErrorCode	Kod błędu najwyższego poziomu
details	Error[]	Dodatkowe szczegóły pomocnicze dotyczące błędów i/lub oczekiwanych zasad.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).
message	string	Komunikat o błędzie najwyższego poziomu.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

ErrorCode

Wyliczanie

Kod błędu najwyższego poziomu

Wartość	Opis
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Objekt

Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w witrynie https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nazwa	Typ	Opis
error	Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

InnerError

Objekt

Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).

Nazwa	Typ	Opis
code	string	Szczegółowy kod błędu pomocny w diagnostyce.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi w https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).
message	string	Szczegółowy komunikat o błędzie.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

Udostępnij za pośrednictwem

Training Sets - Upload Data

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Zabezpieczenia

Ocp-Apim-Subscription-Key

Przykłady

Upload data to a training set

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError