Datasets - Create

Usługa:: Azure AI Services

Wersja interfejsu API:: 2025-10-15

Przekazuje i tworzy nowy zestaw danych, pobierając dane z określonego adresu URL lub rozpoczyna oczekiwanie na przekazanie bloków danych.

POST {endpoint}/speechtotext/datasets?api-version=2025-10-15

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://westus.api.cognitive.microsoft.com).
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string	Podaj klucz konta usług Cognitive Services w tym miejscu.

Treść żądania

Nazwa	Wymagane	Typ	Opis
displayName	True	string minLength: 1	Nazwa wyświetlana obiektu.
kind	True	DatasetKind	DatasetKind Rodzaj importu danych.
locale	True	string minLength: 1	Ustawienia regionalne zawartych danych.
contentUrl		string (uri)	Adres URL danych zestawu danych.
customProperties		object	Właściwości niestandardowe tej jednostki. Maksymalna dozwolona długość klucza to 64 znaki, maksymalna dozwolona długość wartości to 256 znaków, a liczba dozwolonych wpisów to 10.
description		string	Opis obiektu.
project		EntityReference	EntityReference
properties		DatasetProperties	Zestaw danychWłaściwości

Odpowiedzi

Nazwa	Typ	Opis
201 Created	Dataset	Odpowiedź zawiera informacje o jednostce jako ładunku i jego lokalizacji jako nagłówku. Nagłówki Location: string
Other Status Codes	Error	Wystąpił błąd.

Nazwa

Typ

Opis

201 Created

Dataset

Odpowiedź zawiera informacje o jednostce jako ładunku i jego lokalizacji jako nagłówku.

Nagłówki

Location: string

Other Status Codes

Error

Wystąpił błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Podaj klucz konta usług Cognitive Services w tym miejscu.

Typ: apiKey
W: header

Przykłady

Create a dataset with content url

Create dataset from data blocks

Create a dataset with content url

Przykładowe żądanie

HTTP

POST {endpoint}/speechtotext/datasets?api-version=2025-10-15


{
  "displayName": "My speech dataset name",
  "description": "My speech dataset description",
  "locale": "en-US",
  "kind": "Acoustic",
  "contentUrl": "https://contoso.com/location"
}

Przykładowa odpowiedź

Kod stanu:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15",
  "displayName": "Acoustic dataset",
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "kind": "Acoustic",
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files?api-version=2025-10-15"
  },
  "properties": {
    "acceptedLineCount": 11,
    "rejectedLineCount": 2,
    "durationMilliseconds": 252000,
    "textNormalizationKind": "Default"
  },
  "contentUrl": "https://www.contoso.com/acousticdata/sourcelocation",
  "status": "Succeeded"
}

Create dataset from data blocks

Przykładowe żądanie

HTTP

POST {endpoint}/speechtotext/datasets?api-version=2025-10-15


{
  "displayName": "My speech dataset name",
  "description": "My speech dataset description",
  "locale": "en-US",
  "kind": "Acoustic"
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15",
  "displayName": "Acoustic dataset",
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "kind": "Acoustic",
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15/files?api-version=2025-10-15",
    "commitBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15/blocks:commit?api-version=2025-10-15",
    "listBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15/blocks?api-version=2025-10-15",
    "uploadBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1?api-version=2025-10-15/blocks?api-version=2025-10-15"
  },
  "status": "NotStarted"
}

Definicje

Nazwa	Opis
Dataset	Dataset
DatasetKind	DatasetKind
DatasetLinks	Linki do zestawów danych
DatasetProperties	Zestaw danychWłaściwości
DetailedErrorCode	Szczegółowy kod błędu
EntityError	Błąd jednostki
EntityReference	EntityReference
Error	Error
ErrorCode	ErrorCode
InnerError	InnerError
Status	Status
TextNormalizationKind	TextNormalizationKind

Dataset

Objekt

Dataset

Nazwa	Typ	Opis
contentUrl	string (uri)	Adres URL danych zestawu danych.
createdDateTime	string (date-time)	Sygnatura czasowa utworzenia obiektu. Znacznik czasu jest zakodowany w formacie daty i godziny ISO 8601 ("RRRR-MM-DDTgg:mm:ssZ", patrz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Właściwości niestandardowe tej jednostki. Maksymalna dozwolona długość klucza to 64 znaki, maksymalna dozwolona długość wartości to 256 znaków, a liczba dozwolonych wpisów to 10.
description	string	Opis obiektu.
displayName	string minLength: 1	Nazwa wyświetlana obiektu.
kind	DatasetKind	DatasetKind Rodzaj importu danych.
lastActionDateTime	string (date-time)	Sygnatura czasowa, w której wprowadzono bieżący stan. Znacznik czasu jest zakodowany w formacie daty i godziny ISO 8601 ("RRRR-MM-DDTgg:mm:ssZ", patrz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	DatasetLinks	Linki do zestawów danych
locale	string minLength: 1	Ustawienia regionalne zawartych danych.
project	EntityReference	EntityReference
properties	DatasetProperties	Zestaw danychWłaściwości
self	string (uri)	Lokalizacja tej jednostki.
status	Status	Status Opisz bieżący stan interfejsu API.

DatasetKind

Wyliczanie

DatasetKind

Wartość	Opis
Language	Zestaw danych języka.
Acoustic	Zestaw danych akustycznych.
Pronunciation	Zestaw danych wymowy.
AudioFiles	Zestaw danych plików audio.
LanguageMarkdown	Zestaw danych języka Markdown.
OutputFormatting	Zestaw danych, który zawiera reguły umożliwiające dostosowanie normalizacji tekstu odwrotnego, wielkich liter, przeformułowania, wulgaryzmów, a także definiuje testy walidacji zestawu danych

DatasetLinks

Objekt

Linki do zestawów danych

Nazwa	Typ	Opis
commitBlocks	string (uri)	Lokalizacja, w której ma zostać zatwierdzona lista bloków podczas przekazywania zestawu danych przy użyciu bloków. Zobacz operację "Datasets_CommitBlocks", aby uzyskać więcej informacji.
files	string (uri)	Lokalizacja, z której mają zostać pobrane wszystkie pliki tej jednostki. Zobacz operację "Datasets_ListFiles", aby uzyskać więcej informacji.
listBlocks	string (uri)	Lokalizacja, w której ma zostać wyświetlona lista już przekazanych bloków tej jednostki podczas przekazywania zestawu danych przy użyciu bloków. Zobacz operację "Datasets_GetBlocks", aby uzyskać więcej informacji.
uploadBlocks	string (uri)	Lokalizacja, do której mają być przekazywane bloki podczas przekazywania zestawu danych przy użyciu bloków. Zobacz operację "Datasets_UploadBlock", aby uzyskać więcej informacji.

DatasetProperties

Objekt

Zestaw danychWłaściwości

Nazwa	Typ	Domyślna wartość	Opis
acceptedLineCount	integer (int32)		Liczba wierszy akceptowanych dla tego zestawu danych.
durationMilliseconds	integer (int64)	0	Łączny czas trwania zestawów danych w milisekundach, jeśli zawierają pliki audio. Czasy trwania większe niż 2^53-1 nie są obsługiwane w celu zapewnienia zgodności z liczbami całkowitymi JavaScript.
error	EntityError		Błąd jednostki
rejectedLineCount	integer (int32)		Liczba wierszy odrzuconych dla tego zestawu danych.
textNormalizationKind	TextNormalizationKind		TextNormalizationKind Rodzaj normalizacji tekstu.

DetailedErrorCode

Wyliczanie

Szczegółowy kod błędu

Wartość	Opis
InvalidParameterValue	Nieprawidłowa wartość parametru.
InvalidRequestBodyFormat	Nieprawidłowy format treści żądania.
EmptyRequest	Puste żądanie.
MissingInputRecords	Brakujące rekordy wejściowe.
InvalidDocument	Nieprawidłowy dokument.
ModelVersionIncorrect	Nieprawidłowa wersja modelu.
InvalidDocumentBatch	Nieprawidłowa partia dokumentów.
UnsupportedLanguageCode	Nieobsługiwany kod języka.
DataImportFailed	Importowanie danych nie powiodło się.
InUseViolation	Naruszenie zasad użytkowania.
InvalidLocale	Nieprawidłowe ustawienia regionalne.
InvalidBaseModel	Nieprawidłowy model podstawowy.
InvalidAdaptationMapping	Nieprawidłowe mapowanie adaptacji.
InvalidDataset	Nieprawidłowy zestaw danych.
InvalidTest	Nieprawidłowy test.
FailedDataset	Zestaw danych, który zakończył się niepowodzeniem.
InvalidModel	Nieprawidłowy model.
InvalidTranscription	Nieprawidłowa transkrypcja.
InvalidPayload	Nieprawidłowy ładunek.
InvalidParameter	Nieprawidłowy parametr.
EndpointWithoutLogging	Punkt końcowy bez rejestrowania.
InvalidPermissions	Nieprawidłowe uprawnienia.
InvalidPrerequisite	Nieprawidłowy warunek wstępny.
InvalidProductId	Nieprawidłowy identyfikator produktu.
InvalidSubscription	Nieprawidłowa subskrypcja.
InvalidProject	Nieprawidłowy projekt.
InvalidProjectKind	Nieprawidłowy rodzaj projektu.
InvalidRecordingsUri	Nieprawidłowy identyfikator URI nagrań.
OnlyOneOfUrlsOrContainerOrDataset	Tylko jeden z adresów URL, kontener lub zestaw danych.
ExceededNumberOfRecordingsUris	Przekroczono liczbę identyfikatorów URI nagrań.
InvalidChannels	Nieprawidłowe kanały.
ModelMismatch	Niezgodność modelu.
ProjectGenderMismatch	Projekt niedopasowania płci.
ModelDeprecated	Model przestarzały.
ModelExists	Model istnieje.
ModelNotDeployable	Model nie można wdrożyć.
EndpointNotUpdatable	Nie można zaktualizować punktu końcowego.
SingleDefaultEndpoint	Pojedynczy domyślny punkt końcowy.
EndpointCannotBeDefault	Punkt końcowy nie może być domyślny.
InvalidModelUri	Nieprawidłowy identyfikator URI modelu.
SubscriptionNotFound	Nie znaleziono subskrypcji.
QuotaViolation	Naruszenie limitu przydziału.
UnsupportedDelta	Nieobsługiwana delta.
UnsupportedFilter	Nieobsługiwany filtr.
UnsupportedPagination	Nieobsługiwana stronicowanie.
UnsupportedDynamicConfiguration	Nieobsługiwana konfiguracja dynamiczna.
UnsupportedOrderBy	Nieobsługiwane zamówienie przez.
NoUtf8WithBom	Brak utf8 z bom.
ModelDeploymentNotCompleteState	Wdrożenie modelu nie jest ukończonym stanem.
SkuLimitsExist	Istnieją limity jednostek SKU.
DeployingFailedModel	Wdrażanie modelu, który zakończył się niepowodzeniem.
UnsupportedTimeRange	Nieobsługiwany zakres czasu.
InvalidLogDate	Nieprawidłowa data logowania.
InvalidLogId	Nieprawidłowy identyfikator dziennika.
InvalidLogStartTime	Nieprawidłowa godzina rozpoczęcia dziennika.
InvalidLogEndTime	Nieprawidłowy czas zakończenia dziennika.
InvalidTopForLogs	Nieprawidłowa góra dla dzienników.
InvalidSkipTokenForLogs	Nieprawidłowy token pomijania dzienników.
DeleteNotAllowed	Usuwanie jest niedozwolone.
Forbidden	Zakazany.
DeployNotAllowed	Wdrażanie jest niedozwolone.
UnexpectedError	Nieoczekiwany błąd.
InvalidCollection	Nieprawidłowa kolekcja.
InvalidCallbackUri	Nieprawidłowy identyfikator URI wywołania zwrotnego.
InvalidSasValidityDuration	Nieprawidłowy czas ważności sygnatury dostępu współdzielonego.
InaccessibleCustomerStorage	Niedostępny magazyn klienta.
UnsupportedClassBasedAdaptation	Nieobsługiwana adaptacja oparta na klasach.
InvalidWebHookEventKind	Nieprawidłowy rodzaj zdarzenia elementu webhook.
InvalidTimeToLive	Nieprawidłowy czas zamieszkania.
InvalidSourceAzureResourceId	Nieprawidłowy identyfikator źródłowego zasobu platformy Azure.
ModelCopyAuthorizationExpired	Wygasła autoryzacja ModelCopyAuthorization.
EndpointLoggingNotSupported	Rejestrowanie punktów końcowych nie jest obsługiwane.
NoLanguageIdentified	Identyfikacja języka nie rozpoznała żadnego języka.
MultipleLanguagesIdentified	Identyfikacja języka rozpoznała wiele języków. Nie udało się ustalić języka dominującego.
InvalidAudioFormat	Format dźwięku wejściowego nie jest obsługiwany.
BadChannelConfiguration	Istnieje niezgodność między kanałami audio w danych, konfiguracji lub wymaganiach aplikacji.
InvalidChannelSpecification	Wybór kanałów w żądaniu transkrypcji nie jest obsługiwany (np. nie wybrano ani 0, ani 1).
AudioLengthLimitExceeded	Plik audio jest dłuższy niż maksymalny dozwolony czas trwania.
EmptyAudioFile	Plik audio jest pusty.

EntityError

Objekt

Błąd jednostki

Nazwa	Typ	Opis
code	string	Kod tego błędu.
message	string	Komunikat dotyczący tego błędu.

EntityReference

Objekt

EntityReference

Nazwa	Typ	Opis
self	string (uri)	Lokalizacja odwoływania się do jednostki.

Error

Objekt

Error

Nazwa	Typ	Opis
code	ErrorCode	ErrorCode Kody błędów wysokiego poziomu.
details	Error[]	Dodatkowe informacje pomocnicze dotyczące błędu i/lub oczekiwanych zasad.
innerError	InnerError	InnerError Nowy format błędu wewnętrznego, który jest zgodny z wytycznymi dotyczącymi interfejsu API usług Cognitive Services, który jest dostępny pod adresem https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Zawiera wymagane właściwości: ErrorCode, message i opcjonalne właściwości target, details (para klucz-wartość), błąd wewnętrzny (może być zagnieżdżony).
message	string	Ogólny komunikat o błędzie.
target	string	Źródło błędu. Na przykład będzie to "dokumenty" lub "identyfikator dokumentu" w przypadku nieprawidłowego dokumentu.

ErrorCode

Wyliczanie

ErrorCode

Wartość	Opis
InvalidRequest	Reprezentuje nieprawidłowy kod błędu żądania.
InvalidArgument	Reprezentujący kod błędu nieprawidłowego argumentu.
InternalServerError	Reprezentujący kod błędu wewnętrznego serwera.
ServiceUnavailable	Reprezentujący kod błędu niedostępności usługi.
NotFound	Reprezentuje kod błędu nie znaleziono.
PipelineError	Reprezentujący kod błędu potoku.
Conflict	Reprezentujący kod błędu konfliktu.
InternalCommunicationFailed	Reprezentowanie kodu błędu komunikacji wewnętrznej nie powiodło się.
Forbidden	Reprezentuje zabroniony kod błędu.
NotAllowed	Reprezentuje niedozwolony kod błędu.
Unauthorized	Reprezentuje nieautoryzowany kod błędu.
UnsupportedMediaType	Reprezentuje kod błędu nieobsługiwanego typu nośnika.
TooManyRequests	Reprezentujący kod błędu zbyt wielu żądań.
UnprocessableEntity	Reprezentujący kod błędu jednostki, której nie można przetworzyć.

InnerError

Objekt

InnerError

Nazwa	Typ	Opis
code	DetailedErrorCode	Szczegółowy kod błędu Szczegółowy kod błędu wyliczenie.
details	object	Dodatkowe informacje pomocnicze dotyczące błędu i/lub oczekiwanych zasad.
innerError	InnerError	InnerError Nowy format błędu wewnętrznego, który jest zgodny z wytycznymi dotyczącymi interfejsu API usług Cognitive Services, który jest dostępny pod adresem https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Zawiera wymagane właściwości: ErrorCode, message i opcjonalne właściwości target, details (para klucz-wartość), błąd wewnętrzny (może być zagnieżdżony).
message	string	Ogólny komunikat o błędzie.
target	string	Źródło błędu. Na przykład będzie to "dokumenty" lub "identyfikator dokumentu" w przypadku nieprawidłowego dokumentu.

Status

Wyliczanie

Status

Wartość	Opis
NotStarted	Długotrwała operacja jeszcze się nie rozpoczęła.
Running	Długotrwała operacja jest obecnie przetwarzana.
Succeeded	Długotrwała operacja zakończyła się pomyślnie.
Failed	Długotrwała operacja zakończyła się niepowodzeniem.

TextNormalizationKind

Wyliczanie

TextNormalizationKind

Wartość	Opis
Default	Domyślna normalizacja tekstu (np. "2 do 3" jest zastępowane przez "dwa do trzech" w en-US).
None	Do tekstu wejściowego nie zostanie zastosowana żadna normalizacja tekstu. Jest to opcja zastępowania, która powinna być używana tylko wtedy, gdy tekst jest znormalizowany przed przekazaniem.