Models - Create

Szolgáltatás:

Azure AI Services

API-verzió:

2023-04-01-preview

Egyéni modell betanításának megkezdése.

Visszaadott állapotkódok:

• 201: A művelet sikeresen befejeződött.
• 400: A kérés helytelenül lett formázva.
• 409: A megadott névvel rendelkező modell már létezik.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Egy név, amellyel egyedileg azonosítható a modell létrehozása után.
api-version	query	True	string	Kért API-verzió.

Kérelem törzse

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

Name	Kötelező	Típus	Description
trainingParameters	True	TrainingParameters	A betanítási futtatás egyéni modellek betanítási módjának megadására szolgáló paraméterek.
createdDateTime		string (date-time)	Csak olvasható. A betanítási futtatás első létrehozásának dátuma és időpontja UTC-ben.
error		ErrorResponseDetails	Hibainformációk.
evaluationParameters		ModelEvaluationParameters	Paraméterek a modell kiértékelésének módjának megadásához.
modelPerformance		ModelPerformance	Egyéni betanított modell teljesítménymetrikái.
name		string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Csak olvasható. A betanítási futtatás egyedi azonosításához használt név.
status		ModelState	Csak olvasható. A betanítási futtatás aktuális állapota.
updatedDateTime		string (date-time)	Csak olvasható. A betanítási futtatás utolsó frissítésének dátuma és időpontja UTC-ben.

Válaszok

Name	Típus	Description
201 Created	Model	Létrehozott
Other Status Codes	ErrorResponse	Hiba Fejlécek x-ms-error-code: string

Példák

Models_Create

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkó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"
  }
}

Definíciók

Name	Description
ErrorResponse	Hiba esetén visszaadott válasz.
ErrorResponseDetails	Hibainformációk.
ErrorResponseInnerError	Részletes hiba.
Model	Az egyéni modellek betanítására szolgáló betanítási futtatás leírása.
ModelEvaluationParameters	Paraméterek a modell kiértékelésének módjának megadásához.
ModelKind	Modell típusa.
ModelPerformance	Egyéni betanított modell teljesítménymetrikái.
ModelState	Csak olvasható. A betanítási futtatás aktuális állapota.
ModelTagPerformance	Az egyéni betanított modell által felismert címkék teljesítménymetrikái.
TrainingParameters	A betanítási futtatás egyéni modellek betanítási módjának megadására szolgáló paraméterek.

ErrorResponse

Objektum

Hiba esetén visszaadott válasz.

Name	Típus	Description
error	ErrorResponseDetails	Hibainformációk.

ErrorResponseDetails

Objektum

Hibainformációk.

Name	Típus	Description
code	string	Hibakód.
details	ErrorResponseDetails[]	A részletes hibák listája.
innererror	ErrorResponseInnerError	Részletes hiba.
message	string	Hibaüzenet.
target	string	A hiba célja.

ErrorResponseInnerError

Objektum

Részletes hiba.

Name	Típus	Description
code	string	Hibakód.
innererror	ErrorResponseInnerError	Részletes hiba.
message	string	Hibaüzenet.

Model

Objektum

Az egyéni modellek betanítására szolgáló betanítási futtatás leírása.

Name	Típus	Description
createdDateTime	string (date-time)	Csak olvasható. A betanítási futtatás első létrehozásának dátuma és időpontja UTC-ben.
error	ErrorResponseDetails	Hibainformációk.
evaluationParameters	ModelEvaluationParameters	Paraméterek a modell kiértékelésének módjának megadásához.
modelPerformance	ModelPerformance	Egyéni betanított modell teljesítménymetrikái.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Csak olvasható. A betanítási futtatás egyedi azonosításához használt név.
status	ModelState	Csak olvasható. A betanítási futtatás aktuális állapota.
trainingCostInMinutes	integer (int32)	Csak olvasható. A ténylegesen felhasznált betanítási költség percekben. Csak akkor jelenik meg, ha a betanítás befejeződött.
trainingParameters	TrainingParameters	A betanítási futtatás egyéni modellek betanítási módjának megadására szolgáló paraméterek.
updatedDateTime	string (date-time)	Csak olvasható. A betanítási futtatás utolsó frissítésének dátuma és időpontja UTC-ben.

ModelEvaluationParameters

Objektum

Paraméterek a modell kiértékelésének módjának megadásához.

Name	Típus	Description
testDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	A teszteléshez használt adatkészlet neve.

ModelKind

Enumerálás

Modell típusa.

Érték	Description
Generic-Classifier
Generic-Detector
Product-Recognizer

ModelPerformance

Objektum

Egyéni betanított modell teljesítménymetrikái.

Name	Típus	Description
accuracyTop1	number (double)	Csak olvasható. Többosztályos besorolási modellekhez. A tesztminták aránya, ahol a földi igazság osztály megfelel az előrejelzett osztálynak.
accuracyTop5	number (double)	Csak olvasható. Többosztályos besorolási modellekhez. A tesztminták aránya, ahol az alapigazsági osztály az első öt előrejelzett osztályban van.
averagePrecision	number (double)	Csak olvasható. A modell teljesítményének mértéke, amely a pontosságot és a visszahívást különböző megbízhatósági küszöbértékeken összegzi.
calibrationECE	number (double)	Csak olvasható. Többosztályos besorolási modellekhez. Várható kalibrációs hiba.
meanAveragePrecision30	number (double)	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 30%küszöbértéken .
meanAveragePrecision50	number (double)	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 50%küszöbértéken .
meanAveragePrecision75	number (double)	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 75%küszöbértéken .
tagPerformance	<string,  ModelTagPerformance>	Csak olvasható. A modell által felismert címkék teljesítménymetrikái.

ModelState

Enumerálás

Csak olvasható. A betanítási futtatás aktuális állapota.

Érték	Description
cancelled
cancelling
failed
notStarted
succeeded
training

ModelTagPerformance

Objektum

Az egyéni betanított modell által felismert címkék teljesítménymetrikái.

Name	Típus	Description
accuracy	number (double)	Csak olvasható. Többosztályos modellekhez. Címke pontossága.
averagePrecision50	number (double)	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 50%küszöbértéken .

TrainingParameters

Objektum

A betanítási futtatás egyéni modellek betanítási módjának megadására szolgáló paraméterek.

Name	Típus	Description
modelKind	ModelKind	Modell típusa.
timeBudgetInHours	integer (int32) minimum: 1 maximum: 1344	A betanítás időkerete órákban. A minimálisan engedélyezett érték 1, a GenericClassifier esetében pedig 336 óra, a GenericDetector esetében 1344 óra. Ez a modell betanítása során eltöltött maximális számítási idő.
trainingDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	A betanításhoz használt adatkészlet neve.