Models - Get

Service:

Azure AI Services

API-versie:

2023-04-01-preview

Informatie over een specifiek model ophalen.

Geretourneerde statuscodes:

• 200: De bewerking is voltooid.
• 400: Het verzoek is onjuist ingedeeld.
• 404: Er is geen model met de opgegeven naam gevonden.

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

URI-parameters

Name	In	Vereist	Type	Description
name	path	True	string	De naam van het model dat u wilt ophalen. Regex-patroon: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Aangevraagde API-versie.

Antwoorden

Name	Type	Description
200 OK	Model	Geslaagd
Other Status Codes	ErrorResponse	Fout Kopteksten x-ms-error-code: string

Voorbeelden

Models_Get

Voorbeeldaanvraag

HTTP

GET /models/my_model_name?api-version=2023-04-01-preview

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
ErrorResponse	Antwoord geretourneerd wanneer er een fout optreedt.
ErrorResponseDetails	Foutinformatie.
ErrorResponseInnerError	Gedetailleerde fout.
Model	Beschrijft een trainingsuitvoering voor het trainen van een aangepast model.
ModelEvaluationParameters	Parameters voor het opgeven van hoe een model wordt geëvalueerd.
ModelKind	Model soort.
ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
ModelState	Alleen-lezen. De huidige status van de trainingsuitvoering.
ModelTagPerformance	Metrische prestatiegegevens voor elke tag die wordt herkend door een aangepast getraind model.
TrainingParameters	Parameters voor het opgeven van hoe een trainingsuitvoering een aangepast model traint.

ErrorResponse

Antwoord geretourneerd wanneer er een fout optreedt.

Name	Type	Description
error	ErrorResponseDetails	Foutinformatie.

ErrorResponseDetails

Foutinformatie.

Name	Type	Description
code	string	Foutcode.
details	ErrorResponseDetails[]	Lijst met gedetailleerde fouten.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutmelding.
target	string	Doel van de fout.

ErrorResponseInnerError

Gedetailleerde fout.

Name	Type	Description
code	string	Foutcode.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutmelding.

Model

Beschrijft een trainingsuitvoering voor het trainen van een aangepast model.

Name	Type	Description
createdDateTime	string	Alleen-lezen. De datum en tijd waarop de trainingsuitvoering voor het eerst is gemaakt, in UTC.
error	ErrorResponseDetails	Foutinformatie.
evaluationParameters	ModelEvaluationParameters	Parameters voor het opgeven van hoe een model wordt geëvalueerd.
modelPerformance	ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
name	string	Alleen-lezen. De naam die wordt gebruikt om de trainingsuitvoering uniek te identificeren.
status	ModelState	Alleen-lezen. De huidige status van de trainingsuitvoering.
trainingCostInMinutes	integer	Alleen-lezen. Werkelijke verbruikte trainingskosten in minuten. Alleen aanwezig als de training wordt uitgevoerd als voltooid.
trainingParameters	TrainingParameters	Parameters voor het opgeven van hoe een trainingsuitvoering een aangepast model traint.
updatedDateTime	string	Alleen-lezen. De datum en tijd waarop de trainingsuitvoering voor het laatst is bijgewerkt, in UTC.

ModelEvaluationParameters

Parameters voor het opgeven van hoe een model wordt geëvalueerd.

Name	Type	Description
testDatasetName	string	De naam van de gegevensset die wordt gebruikt voor het testen.

ModelKind

Model soort.

Name	Type	Description
Generic-Classifier	string
Generic-Detector	string
Product-Recognizer	string

ModelPerformance

Metrische prestatiegegevens voor een aangepast getraind model.

Name	Type	Description
accuracyTop1	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Het aandeel testmonsters waarbij de grondwaarheidsklasse overeenkomt met de voorspelde klasse.
accuracyTop5	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Het aandeel testmonsters waarbij de klasse ground truth zich in de top vijf voorspelde klassen bevindt.
averagePrecision	number	Alleen-lezen. Dit is een meting van de prestaties van het model en geeft een overzicht van de precisie en relevante overeenkomsten bij verschillende betrouwbaarheidsdrempels.
calibrationECE	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Verwachte kalibratiefout.
meanAveragePrecision30	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde precisie bij een drempelwaarde van 30%.
meanAveragePrecision50	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde gemiddelde precisie bij een drempelwaarde van 50%.
meanAveragePrecision75	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde gemiddelde precisie bij een drempelwaarde van 75%.
tagPerformance	<string,  ModelTagPerformance>	Alleen-lezen. Metrische prestatiegegevens voor elke tag die door het model wordt herkend.

ModelState

Alleen-lezen. De huidige status van de trainingsuitvoering.

Name	Type	Description
cancelled	string
cancelling	string
failed	string
notStarted	string
succeeded	string
training	string

ModelTagPerformance

Metrische prestatiegegevens voor elke tag die wordt herkend door een aangepast getraind model.

Name	Type	Description
accuracy	number	Alleen-lezen. Voor modellen met meerdere klassen. Labelnauwkeurigheid.
averagePrecision50	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde precisie bij een drempelwaarde van 50%.

TrainingParameters

Parameters voor het opgeven van hoe een trainingsuitvoering een aangepast model traint.

Name	Type	Description
modelKind	ModelKind	Model soort.
timeBudgetInHours	integer	Tijdsbudget voor training, in uren. De minimaal toegestane waarde is 1 en de maximaal toegestane waarde is 336 uur voor GenericClassifier en 1344 uur voor GenericDetector. Dit is de maximale hoeveelheid rekentijd die wordt besteed aan het trainen van het model.
trainingDatasetName	string	De naam van de gegevensset die wordt gebruikt voor de training.