Models - Create

Služba:

Azure AI Services

Verze rozhraní API:

2023-04-01-preview

Začněte trénovat vlastní model.

Vrácené stavové kódy:

• 201: Operace byla úspěšně dokončena.
• 400: Žádost byla poškozena.
• 409: Model se zadaným názvem již existuje.

PUT /models/{name}?api-version=2023-04-01-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Název, který lze použít k jednoznačné identifikaci modelu po jeho vytvoření.
api-version	query	True	string	Požadovaná verze rozhraní API

Text požadavku

Media Types: "application/json-patch+json"

Name	Vyžadováno	Typ	Description
trainingParameters	True	TrainingParameters	Parametry pro určení způsobu trénování trénování trénování vlastního modelu
createdDateTime		string (date-time)	Jen pro čtení. Datum a čas prvního vytvoření trénovacího spuštění v UTC.
error		ErrorResponseDetails	Informace o chybě
evaluationParameters		ModelEvaluationParameters	Parametry pro určení způsobu vyhodnocení modelu
modelPerformance		ModelPerformance	Metriky výkonu pro vlastní natrénovaný model
name		string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Jen pro čtení. Název, který se používá k jednoznačné identifikaci trénovacího spuštění.
status		ModelState	Jen pro čtení. Aktuální stav spuštění trénování.
updatedDateTime		string (date-time)	Jen pro čtení. Datum a čas poslední aktualizace trénovacího spuštění v UTC.

Odpovědi

Name	Typ	Description
201 Created	Model	Vytvořeno
Other Status Codes	ErrorResponse	Chyba Hlavičky x-ms-error-code: string

Příklady

Models_Create

Ukázkový požadavek

HTTP

PUT /models/model_name?api-version=2023-04-01-preview

{
  "trainingParameters": {
    "timeBudgetInHours": 100,
    "trainingDatasetName": "my_dataset_name"
  }
}

Ukázková odpověď

Stavový kód:

201

{
  "name": "model_name",
  "createdDateTime": "2023-01-13T20:46:21.210Z",
  "updatedDateTime": "2023-01-13T20:46:21.210Z",
  "status": "notStarted",
  "trainingParameters": {
    "timeBudgetInHours": 100,
    "trainingDatasetName": "my_dataset_name"
  }
}

Definice

Name	Description
ErrorResponse	Odpověď se vrátí, když dojde k chybě.
ErrorResponseDetails	Informace o chybě
ErrorResponseInnerError	Podrobná chyba
Model	Popisuje trénovací běh pro trénování vlastního modelu.
ModelEvaluationParameters	Parametry pro určení způsobu vyhodnocení modelu
ModelKind	Druh modelu.
ModelPerformance	Metriky výkonu pro vlastní natrénovaný model
ModelState	Jen pro čtení. Aktuální stav spuštění trénování.
ModelTagPerformance	Metriky výkonu pro každou značku rozpoznanou vlastním natrénovaným modelem
TrainingParameters	Parametry pro určení způsobu trénování trénování trénování vlastního modelu

ErrorResponse

Objekt

Odpověď se vrátí, když dojde k chybě.

Name	Typ	Description
error	ErrorResponseDetails	Informace o chybě

ErrorResponseDetails

Objekt

Informace o chybě

Name	Typ	Description
code	string	Kód chyby
details	ErrorResponseDetails[]	Seznam podrobných chyb
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.
target	string	Cíl chyby.

ErrorResponseInnerError

Objekt

Podrobná chyba

Name	Typ	Description
code	string	Kód chyby
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.

Model

Objekt

Popisuje trénovací běh pro trénování vlastního modelu.

Name	Typ	Description
createdDateTime	string (date-time)	Jen pro čtení. Datum a čas prvního vytvoření trénovacího spuštění v UTC.
error	ErrorResponseDetails	Informace o chybě
evaluationParameters	ModelEvaluationParameters	Parametry pro určení způsobu vyhodnocení modelu
modelPerformance	ModelPerformance	Metriky výkonu pro vlastní natrénovaný model
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Jen pro čtení. Název, který se používá k jednoznačné identifikaci trénovacího spuštění.
status	ModelState	Jen pro čtení. Aktuální stav spuštění trénování.
trainingCostInMinutes	integer (int32)	Jen pro čtení. Skutečné náklady na trénování spotřebované v minutách Prezentovat pouze v případě, že se trénování spustí jako dokončené.
trainingParameters	TrainingParameters	Parametry pro určení způsobu trénování trénování trénování vlastního modelu
updatedDateTime	string (date-time)	Jen pro čtení. Datum a čas poslední aktualizace trénovacího spuštění v UTC.

ModelEvaluationParameters

Objekt

Parametry pro určení způsobu vyhodnocení modelu

Name	Typ	Description
testDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Název datové sady, který se používá k testování.

ModelKind

Výčet

Druh modelu.

Hodnota	Description
Generic-Classifier
Generic-Detector
Product-Recognizer

ModelPerformance

Objekt

Metriky výkonu pro vlastní natrénovaný model

Name	Typ	Description
accuracyTop1	number (double)	Jen pro čtení. Pro vícetřídové klasifikační modely. Podíl zkušebních vzorků, kde základní třída pravdy odpovídá predikované třídě.
accuracyTop5	number (double)	Jen pro čtení. Pro vícetřídové klasifikační modely. Podíl zkušebních vzorků, kde je základní třída pravdy v prvních pěti predikovaných třídách.
averagePrecision	number (double)	Jen pro čtení. Míra výkonu modelu shrnuje přesnost a úplnost při různých prahových hodnotách spolehlivosti.
calibrationECE	number (double)	Jen pro čtení. Pro vícetřídové klasifikační modely. Byla očekáváná chyba kalibrace.
meanAveragePrecision30	number (double)	Jen pro čtení. Pro modely detekce objektů. Průměrná průměrná přesnost při prahové hodnotě 30%.
meanAveragePrecision50	number (double)	Jen pro čtení. Pro modely detekce objektů. Průměrná průměrná přesnost při prahové hodnotě 50%.
meanAveragePrecision75	number (double)	Jen pro čtení. Pro modely detekce objektů. Průměrná průměrná přesnost při prahové hodnotě 75%.
tagPerformance	<string,  ModelTagPerformance>	Jen pro čtení. Metriky výkonu pro každou značku rozpoznanou modelem

ModelState

Výčet

Jen pro čtení. Aktuální stav spuštění trénování.

Hodnota	Description
cancelled
cancelling
failed
notStarted
succeeded
training

ModelTagPerformance

Objekt

Metriky výkonu pro každou značku rozpoznanou vlastním natrénovaným modelem

Name	Typ	Description
accuracy	number (double)	Jen pro čtení. Pro modely s více třídami. Přesnost značek.
averagePrecision50	number (double)	Jen pro čtení. Pro modely detekce objektů. Průměrná přesnost při prahové hodnotě 50%.

TrainingParameters

Objekt

Parametry pro určení způsobu trénování trénování trénování vlastního modelu

Name	Typ	Description
modelKind	ModelKind	Druh modelu.
timeBudgetInHours	integer (int32) minimum: 1 maximum: 1344	Časový rozpočet pro trénování, v hodinách. Minimální povolená hodnota je 1 a maximální povolená hodnota je 336 hodin pro GenericClassifier, 1344 hodin pro GenericDetector. Jedná se o maximální dobu výpočetního výkonu, která bude vynaložena na trénování modelu.
trainingDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Název datové sady používaný pro trénování.