Iterations - List Performance Images
Obtenir une image avec sa prédiction pour une itération de projet donnée. Cette API prend en charge la sélection de lots et de plage. Par défaut, il ne retourne que 50 premières images correspondant aux images. Utilisez les paramètres {take} et {skip} pour contrôler le nombre d’images à retourner dans un lot donné. Le filtrage est sur une relation et/ou une relation. Par exemple, si les ID de balise fournis concernent les balises « Chien » et « Chat », seules les images marquées avec Dog et/ou Cat sont retournées
GET {Endpoint}/customvision/v3.3/training/projects/{projectId}/iterations/{iterationId}/performance/images
GET {Endpoint}/customvision/v3.3/training/projects/{projectId}/iterations/{iterationId}/performance/images?tagIds={tagIds}&orderBy={orderBy}&take={take}&skip={skip}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Points de terminaison Cognitive Services pris en charge. |
iteration
|
path | True |
string (uuid) |
ID d’itération. Valeur par défaut de l’espace de travail. |
project
|
path | True |
string (uuid) |
ID du projet. |
order
|
query |
string |
Ordre. La valeur par défaut est la plus récente. |
|
skip
|
query |
integer (int32) |
Nombre d’images à ignorer avant de commencer le lot d’images. La valeur par défaut est 0. |
|
tag
|
query |
string[] |
Liste des id d’étiquettes pour filtrer les images. Par défaut, toutes les images étiquetées sont null. Limité à 20. |
|
take
|
query |
integer (int32) minimum: 0maximum: 256 |
Nombre maximal d’images à retourner. La valeur par défaut est 50, limitée à 256. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
Training-Key | True |
string |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
D’ACCORD Media Types: "application/json", "application/xml", "text/xml" |
|
Other Status Codes |
Réponse d’erreur Media Types: "application/json", "application/xml", "text/xml" |
Sécurité
Training-Key
Type:
apiKey
Dans:
header
Exemples
Successful GetImagePerformances request
Exemple de requête
GET https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/bc3f7dad-5544-468c-8573-3ef04d55463e/iterations/b7b9d99c-a2c6-4658-9900-a98d2ff5bc66/performance/images?tagIds=65c1de9c-3ee9-4b46-941f-66199b64d155&orderBy=Newest
Exemple de réponse
[
{
"id": "dfd2d346-3ed5-4e1e-857d-af4e32cec042",
"created": "2018-01-31T20:18:26Z",
"predictions": [
{
"tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
"tagName": "Tag 1",
"probability": 1,
"boundingBox": {
"left": 0.25,
"top": 0.25,
"width": 0.25,
"height": 0.25
}
}
],
"width": 600,
"height": 1600,
"imageUri": "<image uri>",
"thumbnailUri": "<thumbnail uri>",
"tags": [],
"regions": []
}
]
Définitions
Nom | Description |
---|---|
Bounding |
Cadre englobant qui définit une région d’une image. |
Custom |
|
Custom |
Code d’erreur. |
Image |
Modèle de performances d’image. |
Image |
|
Image |
|
Prediction |
Résultat de prédiction. |
Tag |
Type de la balise prédite. |
BoundingBox
Cadre englobant qui définit une région d’une image.
Nom | Type | Description |
---|---|---|
height |
number (float) |
Hauteur. |
left |
number (float) |
Coordonnée de la limite gauche. |
top |
number (float) |
Coordonnée de la limite supérieure. |
width |
number (float) |
Largeur. |
CustomVisionError
Nom | Type | Description |
---|---|---|
code |
Code d’erreur. |
|
message |
string |
Message expliquant l’erreur signalée par le service. |
CustomVisionErrorCodes
Code d’erreur.
Valeur | Description |
---|---|
BadRequest | |
BadRequestCannotMigrateProjectWithName | |
BadRequestClassificationTrainingValidationFailed | |
BadRequestCustomerManagedKeyRevoked | |
BadRequestDetectionTrainingNotAllowNegativeTag | |
BadRequestDetectionTrainingValidationFailed | |
BadRequestDomainNotSupportedForAdvancedTraining | |
BadRequestExceedIterationPerProjectLimit | |
BadRequestExceedProjectLimit | |
BadRequestExceedTagPerImageLimit | |
BadRequestExceedTagPerProjectLimit | |
BadRequestExceededBatchSize | |
BadRequestExceededQuota | |
BadRequestExportAlreadyInProgress | |
BadRequestExportPlatformNotSupportedForAdvancedTraining | |
BadRequestExportValidationFailed | |
BadRequestExportWhileTraining | |
BadRequestImageBatch | |
BadRequestImageDimensions | |
BadRequestImageExceededCount | |
BadRequestImageFormat | |
BadRequestImageMetadataKey | |
BadRequestImageMetadataValue | |
BadRequestImageRegions | |
BadRequestImageSizeBytes | |
BadRequestImageStream | |
BadRequestImageTags | |
BadRequestImageUrl | |
BadRequestInvalid | |
BadRequestInvalidArtifactUri | |
BadRequestInvalidEmailAddress | |
BadRequestInvalidIds | |
BadRequestInvalidImportToken | |
BadRequestInvalidPublishName | |
BadRequestInvalidPublishTarget | |
BadRequestIterationDescription | |
BadRequestIterationIsNotTrained | |
BadRequestIterationIsPublished | |
BadRequestIterationName | |
BadRequestIterationNameNotUnique | |
BadRequestIterationNotPublished | |
BadRequestIterationValidationFailed | |
BadRequestMultiClassClassificationTrainingValidationFailed | |
BadRequestMultiLabelClassificationTrainingValidationFailed | |
BadRequestMultipleGeneralProductTag | |
BadRequestMultipleNegativeTag | |
BadRequestNegativeAndRegularTagOnSameImage | |
BadRequestNotLimitedTrial | |
BadRequestNotSupported | |
BadRequestOperationNotSupported | |
BadRequestPredictionIdsExceededCount | |
BadRequestPredictionIdsMissing | |
BadRequestPredictionInvalidApplicationName | |
BadRequestPredictionInvalidQueryParameters | |
BadRequestPredictionResultsExceededCount | |
BadRequestPredictionTagsExceededCount | |
BadRequestProjectDescription | |
BadRequestProjectDuplicated | |
BadRequestProjectImagePreprocessingSettings | |
BadRequestProjectName | |
BadRequestProjectNameNotUnique | |
BadRequestProjectUnknownClassification | |
BadRequestProjectUnknownDomain | |
BadRequestProjectUnsupportedDomainTypeChange | |
BadRequestProjectUnsupportedExportPlatform | |
BadRequestRequiredParamIsNull | |
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining | |
BadRequestSubscriptionApi | |
BadRequestTagDescription | |
BadRequestTagName | |
BadRequestTagNameNotUnique | |
BadRequestTagType | |
BadRequestTrainingAlreadyInProgress | |
BadRequestTrainingNotNeeded | |
BadRequestTrainingNotNeededButTrainingPipelineUpdated | |
BadRequestTrainingValidationFailed | |
BadRequestUnpublishFailed | |
BadRequestUnsupportedDomain | |
BadRequestWorkspaceCannotBeModified | |
BadRequestWorkspaceNotDeletable | |
Conflict | |
ConflictInvalid | |
ErrorExporterInvalidClassifier | |
ErrorExporterInvalidFeaturizer | |
ErrorExporterInvalidPlatform | |
ErrorFeaturizationAugmentationError | |
ErrorFeaturizationAugmentationUnavailable | |
ErrorFeaturizationInvalidFeaturizer | |
ErrorFeaturizationQueueTimeout | |
ErrorFeaturizationServiceUnavailable | |
ErrorFeaturizationUnrecognizedJob | |
ErrorInvalid | |
ErrorIterationCopyFailed | |
ErrorPrediction | |
ErrorPredictionModelNotCached | |
ErrorPredictionModelNotFound | |
ErrorPredictionServiceUnavailable | |
ErrorPredictionStorage | |
ErrorPreparePerformanceMigrationFailed | |
ErrorProjectExportRequestFailed | |
ErrorProjectImportRequestFailed | |
ErrorProjectInvalidDomain | |
ErrorProjectInvalidPipelineConfiguration | |
ErrorProjectInvalidWorkspace | |
ErrorProjectTrainingRequestFailed | |
ErrorRegionProposal | |
ErrorUnknown | |
ErrorUnknownBaseModel | |
Forbidden | |
ForbiddenDRModeEnabled | |
ForbiddenInvalid | |
ForbiddenUser | |
ForbiddenUserDisabled | |
ForbiddenUserDoesNotExist | |
ForbiddenUserInsufficientCapability | |
ForbiddenUserResource | |
ForbiddenUserSignupAllowanceExceeded | |
ForbiddenUserSignupDisabled | |
NoError | |
NotFound | |
NotFoundApimSubscription | |
NotFoundDomain | |
NotFoundImage | |
NotFoundInvalid | |
NotFoundIteration | |
NotFoundIterationPerformance | |
NotFoundProject | |
NotFoundProjectDefaultIteration | |
NotFoundTag | |
UnsupportedMediaType |
ImagePerformance
Modèle de performances d’image.
Nom | Type | Description |
---|---|---|
created |
string (date-time) |
|
height |
integer (int32) |
|
id |
string (uuid) |
|
imageUri |
string |
|
predictions |
Résultat de prédiction. |
|
regions | ||
tags |
Image |
|
thumbnailUri |
string |
|
width |
integer (int32) |
ImageRegion
Nom | Type | Description |
---|---|---|
created |
string (date-time) |
|
height |
number (float) |
Hauteur. |
left |
number (float) |
Coordonnée de la limite gauche. |
regionId |
string (uuid) |
|
tagId |
string (uuid) |
ID de la balise associée à cette région. |
tagName |
string |
|
top |
number (float) |
Coordonnée de la limite supérieure. |
width |
number (float) |
Largeur. |
ImageTag
Nom | Type | Description |
---|---|---|
created |
string (date-time) |
|
tagId |
string (uuid) |
|
tagName |
string |
Prediction
Résultat de prédiction.
Nom | Type | Description |
---|---|---|
boundingBox |
Cadre englobant de la prédiction. |
|
probability |
number (float) |
Probabilité de la balise. |
tagId |
string (uuid) |
ID de la balise prédite. |
tagName |
string |
Nom de la balise prédite. |
tagType |
Type de la balise prédite. |
TagType
Type de la balise prédite.
Valeur | Description |
---|---|
GeneralProduct | |
Negative | |
Regular |