Custom Models - Train

Služba:

Azure AI Services

Verze rozhraní API:

2.1

Create a trénování vlastního modelu. Požadavek musí obsahovat zdrojový parametr, který je buď externě přístupný identifikátor URI kontejneru objektů blob služby Azure Storage (nejlépe identifikátor URI sdíleného přístupového podpisu), nebo platnou cestu ke složce dat na místně připojené jednotce. Pokud jsou zadány místní cesty, musí se řídit formátem cesty pro Linux/Unix a být absolutní cestou, která je kořenem hodnoty nastavení konfigurace vstupního připojení, například pokud je hodnota nastavení konfigurace {Mounts:Input} /input, pak platná cesta ke zdroji bude '/input/contosodataset'. Očekává se, že všechna data, která se mají vytrénovat, budou ve zdrojové složce nebo podsložkách. Modely se trénují pomocí dokumentů, které mají následující typ obsahu: "application/pdf", "image/jpeg", "image/png", "image/tiff" nebo "image/bmp". Jiný typ obsahu se ignoruje.

POST {endpoint}/formrecognizer/v2.1/custom/models

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus2.api.cognitive.microsoft.com).

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Text požadavku

Name	Vyžadováno	Typ	Description
source	True	string	Cesta ke zdroji obsahující trénovací dokumenty.
modelName		string	Volitelný název modelu definovaný uživatelem (maximální délka: 1024)
sourceFilter		TrainSourceFilter	Filtr, který se má použít pro dokumenty ve zdrojové cestě pro trénování.
useLabelFile		boolean	Použijte soubor popisku pro trénování modelu.

Odpovědi

Name	Typ	Description
201 Created		Požadavek se úspěšně zařadil do fronty. Hlavičky Location: string
Other Status Codes	ErrorResponse	Entita odpovědi doprovázející neúspěšné odpovědi obsahující další podrobnosti o chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

Příklady

Train custom model

Train custom model with subfolder filter options

Train custom model

Ukázkový požadavek

HTTP

POST {endpoint}/formrecognizer/v2.1/custom/models


{
  "source": "{azure_blob_endpoint}/input/data1?sasToken"
}

Ukázková odpověď

Stavový kód:

201

Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8

Train custom model with subfolder filter options

Ukázkový požadavek

HTTP

POST {endpoint}/formrecognizer/v2.1/custom/models


{
  "source": "{azure_blob_endpoint}/input/data1?sasToken",
  "sourceFilter": {
    "prefix": "",
    "includeSubFolders": false
  },
  "useLabelFile": false
}

Ukázková odpověď

Stavový kód:

201

Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8

Definice

Name	Description
ErrorInformation
ErrorResponse
TrainRequest	Vyžádejte si parametr pro trénování nového vlastního modelu.
TrainSourceFilter	Filtr, který se má použít pro dokumenty ve zdrojové cestě pro trénování.

ErrorInformation

Name	Typ	Description
code	string
message	string

ErrorResponse

Name	Typ	Description
error	ErrorInformation

TrainRequest

Vyžádejte si parametr pro trénování nového vlastního modelu.

Name	Typ	Default value	Description
modelName	string		Volitelný název modelu definovaný uživatelem (maximální délka: 1024)
source	string		Cesta ke zdroji obsahující trénovací dokumenty.
sourceFilter	TrainSourceFilter		Filtr, který se má použít pro dokumenty ve zdrojové cestě pro trénování.
useLabelFile	boolean	False	Použijte soubor popisku pro trénování modelu.

TrainSourceFilter

Filtr, který se má použít pro dokumenty ve zdrojové cestě pro trénování.

Name	Typ	Default value	Description
includeSubFolders	boolean	False	Příznak označující, jestli bude potřeba zahrnout i podsložky v sadě složek předpon, které budou muset být zahrnuty při hledání obsahu, který se má předzpracovat.
prefix	string		Řetězec předpony rozlišující velká a malá písmena pro filtrování dokumentů ve zdrojové cestě pro účely trénování. Například při použití identifikátoru URI objektu blob služby Azure Storage použijte předponu k omezení podsložek pro trénování.