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érelem helytelenül lett formázva.
• 409: A megadott nevű 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	Egy név, amellyel a modell egyedileg azonosítható a létrehozása után. Reguláris kifejezési minta: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
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	Paraméterek annak megadásához, hogy egy betanítási futtatás hogyan tanít be egy egyéni modellt.
createdDateTime		string	Csak olvasható. A betanítási futtatás első létrehozásának dátuma és időpontja (UTC).
error		ErrorResponseDetails	Hibaadatok.
evaluationParameters		ModelEvaluationParameters	Paraméterek a modell kiértékelésének megadásához.
modelPerformance		ModelPerformance	Egyéni betanított modell teljesítménymetrikái.
name		string	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	Csak olvasható. A betanítási futtatás utolsó frissítésének dátuma és időpontja (UTC).

Válaszok

Name	Típus	Description
201 Created	Model	Létrehozva
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	Hibaadatok.
ErrorResponseInnerError	Részletes hiba.
Model	Betanítási futtatás leírása egyéni modellek betanításához.
ModelEvaluationParameters	Paraméterek a modell kiértékelésének 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	Paraméterek annak megadásához, hogy egy betanítási futtatás hogyan tanít be egy egyéni modellt.

ErrorResponse

Hiba esetén visszaadott válasz.

Name	Típus	Description
error	ErrorResponseDetails	Hibaadatok.

ErrorResponseDetails

Hibaadatok.

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

Részletes hiba.

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

Model

Betanítási futtatás leírása egyéni modellek betanításához.

Name	Típus	Description
createdDateTime	string	Csak olvasható. A betanítási futtatás első létrehozásának dátuma és időpontja (UTC).
error	ErrorResponseDetails	Hibaadatok.
evaluationParameters	ModelEvaluationParameters	Paraméterek a modell kiértékelésének megadásához.
modelPerformance	ModelPerformance	Egyéni betanított modell teljesítménymetrikái.
name	string	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	Csak olvasható. A tényleges betanítási költség percekben megadva. Csak akkor jelenik meg, ha a betanítás befejezettként fut.
trainingParameters	TrainingParameters	Paraméterek annak megadásához, hogy egy betanítási futtatás hogyan tanít be egy egyéni modellt.
updatedDateTime	string	Csak olvasható. A betanítási futtatás utolsó frissítésének dátuma és időpontja (UTC).

ModelEvaluationParameters

Paraméterek a modell kiértékelésének megadásához.

Name	Típus	Description
testDatasetName	string	A teszteléshez használt adathalmaz neve.

ModelKind

Modell típusa.

Name	Típus	Description
Generic-Classifier	string
Generic-Detector	string
Product-Recognizer	string

ModelPerformance

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

Name	Típus	Description
accuracyTop1	number	Csak olvasható. Többosztályos besorolási modellekhez. A tesztminták aránya, ahol a földi igazság osztály megegyezik az előrejelzett osztályban.
accuracyTop5	number	Csak olvasható. Többosztályos besorolási modellekhez. A tesztminták aránya, ahol a földi igazságosztály az első öt előrejelzett osztályban van.
averagePrecision	number	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	Csak olvasható. Többosztályos besorolási modellekhez. Várt kalibrálási hiba.
meanAveragePrecision30	number	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 30%-os küszöbértéknél.
meanAveragePrecision50	number	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 50%-os küszöbértéknél.
meanAveragePrecision75	number	Csak olvasható. Objektumészlelési modellekhez. Átlagos pontosság 75%-os küszöbértéknél.
tagPerformance	<string,  ModelTagPerformance>	Csak olvasható. A modell által felismert címkék teljesítménymetrikái.

ModelState

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

Name	Típus	Description
cancelled	string
cancelling	string
failed	string
notStarted	string
succeeded	string
training	string

ModelTagPerformance

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

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

TrainingParameters

Paraméterek annak megadásához, hogy egy betanítási futtatás hogyan tanít be egy egyéni modellt.

Name	Típus	Description
modelKind	ModelKind	Modell típusa.
timeBudgetInHours	integer	A betanítás időkerete órákban. A minimálisan engedélyezett érték 1, a maximális megengedett érték pedig 336 óra a GenericClassifier esetében, 1344 óra a GenericDetector esetében. Ez a modell betanítása során maximálisan eltöltött számítási idő.
trainingDatasetName	string	A betanításhoz használt adathalmaz neve.