Partager via


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.

iterationId
path True

string (uuid)

ID d’itération. Valeur par défaut de l’espace de travail.

projectId
path True

string (uuid)

ID du projet.

orderBy
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.

tagIds
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: 0
maximum: 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

ImagePerformance[]

D’ACCORD

Media Types: "application/json", "application/xml", "text/xml"

Other Status Codes

CustomVisionError

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
BoundingBox

Cadre englobant qui définit une région d’une image.

CustomVisionError
CustomVisionErrorCodes

Code d’erreur.

ImagePerformance

Modèle de performances d’image.

ImageRegion
ImageTag
Prediction

Résultat de prédiction.

TagType

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

CustomVisionErrorCodes

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

Prediction[]

Résultat de prédiction.

regions

ImageRegion[]

tags

ImageTag[]

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

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

TagType

Type de la balise prédite.

TagType

Type de la balise prédite.

Valeur Description
GeneralProduct
Negative
Regular