Datasets - Upload Block

Usługa:
Azure AI Services
Wersja interfejsu API:
2025-10-15

Przekaż blok danych dla zestawu danych. Maksymalny rozmiar bloku to 8MiB.

PUT {endpoint}/speechtotext/datasets/{id}/blocks?blockid={blockid}&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).
id
 path True

string (uuid)

Identyfikator zbioru danych.
api-version
 query True

string

Żądana wersja interfejsu API.
blockid
 query True

string

Prawidłowa wartość ciągu Base64 identyfikująca blok. Przed kodowaniem ciąg musi mieć rozmiar mniejszy lub równy 64 bajtom. Dla danego obiektu blob długość wartości określonej dla parametru blockid musi być taka sama dla każdego bloku. Pamiętaj, że ciąg Base64 musi być zakodowany w adresie URL.

Nagłówek żądania

Media Types: "application/octet-stream"

Nazwa Wymagane Typ Opis
Ocp-Apim-Subscription-Key True

string

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

Treść żądania

Media Types: "application/octet-stream"

Nazwa Typ Opis
body

string (binary)

Odpowiedzi

Nazwa Typ Opis
201 Created

Blok danych został pomyślnie przesłany.
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

Upload a block for a dataset

Przykładowe żądanie

PUT {endpoint}/speechtotext/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/blocks?blockid=AAE=&api-version=2025-10-15


"{binary}"

Przykładowa odpowiedź

Kod stanu:
201

Definicje

Nazwa Opis
DetailedErrorCode

Szczegółowy kod błędu
Error

Error
ErrorCode

ErrorCode
InnerError

InnerError

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.

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.