Get Image Performances - Get Image Performances

Bild mit der Vorhersage für eine bestimmte Projektiteration
Diese API unterstützt die Batchverarbeitung und Bereichsauswahl. Standardmäßig werden nur die ersten 50 Bilder zurückgegeben, für die sich Übereinstimmungen ergeben. Verwenden Sie die Parameter {take} und {skip}, um zu steuern, wie viele Bilder in einem bestimmten Batch zurückgeben werden. Für die Filterung wird eine UND/ODER-Beziehung verwendet. Wenn die bereitgestellten Tag-IDs beispielsweise für die Tags "Dog" und "Cat" gelten, werden nur Bilder zurückgegeben, die mit Dog und/oder Cat gekennzeichnet sind.

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}

URI-Parameter

Name In Required Type Description
Endpoint
path True
  • string

Unterstützte Cognitive Services Endpunkte.

iterationId
path True
  • string
uuid

Die Iterations-ID. Der Standardwert ist workspace.

projectId
path True
  • string
uuid

Die Projekt-ID.

orderBy
query
  • string

Die Reihenfolge. Der Standardwert ist "neueste".

skip
query
  • integer
int32

Anzahl der Bilder, die vor beginn des Bildbatchs übersprungen werden müssen. Der Standardwert ist 0.

tagIds
query
  • array

Eine Liste von Tags-IDs zum Filtern der Bilder. Standardmäßig werden alle markierten Bilder verwendet, wenn NULL festgelegt ist. Auf 20 beschränkt.

take
query
  • integer
int32

Maximale Anzahl von bildern, die zurückgeben werden. Der Standardwert ist 50, beschränkt auf 256.

Anforderungsheader

Name Required Type Description
Training-Key True
  • string

Antworten

Name Type Description
200 OK

OK

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

Other Status Codes

Fehlerantwort

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

Sicherheit

Training-Key

Type: apiKey
In: header

Beispiele

Successful GetImagePerformances request

Sample Request

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=[

  ""

]&orderBy=Newest
Training-Key: {API Key}

Sample Response

[
  {
    "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": []
  }
]

Definitionen

BoundingBox

Begrenzungsfeld, das einen Bereich eines Bilds definiert.

CustomVisionError
CustomVisionErrorCodes

Der Fehlercode.

ImagePerformance

Bildleistungsmodell.

ImageRegion
ImageTag
Prediction

Vorhersageergebnis.

TagType

Typ des vorhergesagten Tags.

BoundingBox

Begrenzungsfeld, das einen Bereich eines Bilds definiert.

Name Type Description
height
  • number

Höhe.

left
  • number

Koordinate der linken Grenze.

top
  • number

Koordinate der oberen Grenze.

width
  • number

Breite.

CustomVisionError

Name Type Description
code

Der Fehlercode.

message
  • string

Eine Meldung, in der der vom Dienst gemeldete Fehler erläutert wird.

CustomVisionErrorCodes

Der Fehlercode.

Name Type Description
BadRequest
  • string
BadRequestCannotMigrateProjectWithName
  • string
BadRequestClassificationTrainingValidationFailed
  • string
BadRequestCustomerManagedKeyRevoked
  • string
BadRequestDetectionTrainingNotAllowNegativeTag
  • string
BadRequestDetectionTrainingValidationFailed
  • string
BadRequestDomainNotSupportedForAdvancedTraining
  • string
BadRequestExceedIterationPerProjectLimit
  • string
BadRequestExceedProjectLimit
  • string
BadRequestExceedTagPerImageLimit
  • string
BadRequestExceedTagPerProjectLimit
  • string
BadRequestExceededBatchSize
  • string
BadRequestExceededQuota
  • string
BadRequestExportAlreadyInProgress
  • string
BadRequestExportPlatformNotSupportedForAdvancedTraining
  • string
BadRequestExportValidationFailed
  • string
BadRequestExportWhileTraining
  • string
BadRequestImageBatch
  • string
BadRequestImageDimensions
  • string
BadRequestImageExceededCount
  • string
BadRequestImageFormat
  • string
BadRequestImageMetadataKey
  • string
BadRequestImageMetadataValue
  • string
BadRequestImageRegions
  • string
BadRequestImageSizeBytes
  • string
BadRequestImageStream
  • string
BadRequestImageTags
  • string
BadRequestImageUrl
  • string
BadRequestInvalid
  • string
BadRequestInvalidArtifactUri
  • string
BadRequestInvalidEmailAddress
  • string
BadRequestInvalidIds
  • string
BadRequestInvalidImportToken
  • string
BadRequestInvalidPublishName
  • string
BadRequestInvalidPublishTarget
  • string
BadRequestIterationDescription
  • string
BadRequestIterationIsNotTrained
  • string
BadRequestIterationIsPublished
  • string
BadRequestIterationName
  • string
BadRequestIterationNameNotUnique
  • string
BadRequestIterationNotPublished
  • string
BadRequestIterationValidationFailed
  • string
BadRequestMultiClassClassificationTrainingValidationFailed
  • string
BadRequestMultiLabelClassificationTrainingValidationFailed
  • string
BadRequestMultipleGeneralProductTag
  • string
BadRequestMultipleNegativeTag
  • string
BadRequestNegativeAndRegularTagOnSameImage
  • string
BadRequestNotLimitedTrial
  • string
BadRequestNotSupported
  • string
BadRequestOperationNotSupported
  • string
BadRequestPredictionIdsExceededCount
  • string
BadRequestPredictionIdsMissing
  • string
BadRequestPredictionInvalidApplicationName
  • string
BadRequestPredictionInvalidQueryParameters
  • string
BadRequestPredictionResultsExceededCount
  • string
BadRequestPredictionTagsExceededCount
  • string
BadRequestProjectDescription
  • string
BadRequestProjectDuplicated
  • string
BadRequestProjectImagePreprocessingSettings
  • string
BadRequestProjectName
  • string
BadRequestProjectNameNotUnique
  • string
BadRequestProjectUnknownClassification
  • string
BadRequestProjectUnknownDomain
  • string
BadRequestProjectUnsupportedDomainTypeChange
  • string
BadRequestProjectUnsupportedExportPlatform
  • string
BadRequestRequiredParamIsNull
  • string
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining
  • string
BadRequestSubscriptionApi
  • string
BadRequestTagDescription
  • string
BadRequestTagName
  • string
BadRequestTagNameNotUnique
  • string
BadRequestTagType
  • string
BadRequestTrainingAlreadyInProgress
  • string
BadRequestTrainingNotNeeded
  • string
BadRequestTrainingNotNeededButTrainingPipelineUpdated
  • string
BadRequestTrainingValidationFailed
  • string
BadRequestUnpublishFailed
  • string
BadRequestUnsupportedDomain
  • string
BadRequestWorkspaceCannotBeModified
  • string
BadRequestWorkspaceNotDeletable
  • string
Conflict
  • string
ConflictInvalid
  • string
ErrorExporterInvalidClassifier
  • string
ErrorExporterInvalidFeaturizer
  • string
ErrorExporterInvalidPlatform
  • string
ErrorFeaturizationAugmentationError
  • string
ErrorFeaturizationAugmentationUnavailable
  • string
ErrorFeaturizationInvalidFeaturizer
  • string
ErrorFeaturizationQueueTimeout
  • string
ErrorFeaturizationServiceUnavailable
  • string
ErrorFeaturizationUnrecognizedJob
  • string
ErrorInvalid
  • string
ErrorIterationCopyFailed
  • string
ErrorPrediction
  • string
ErrorPredictionModelNotCached
  • string
ErrorPredictionModelNotFound
  • string
ErrorPredictionServiceUnavailable
  • string
ErrorPredictionStorage
  • string
ErrorPreparePerformanceMigrationFailed
  • string
ErrorProjectExportRequestFailed
  • string
ErrorProjectImportRequestFailed
  • string
ErrorProjectInvalidDomain
  • string
ErrorProjectInvalidPipelineConfiguration
  • string
ErrorProjectInvalidWorkspace
  • string
ErrorProjectTrainingRequestFailed
  • string
ErrorRegionProposal
  • string
ErrorUnknown
  • string
ErrorUnknownBaseModel
  • string
Forbidden
  • string
ForbiddenDRModeEnabled
  • string
ForbiddenInvalid
  • string
ForbiddenUser
  • string
ForbiddenUserDisabled
  • string
ForbiddenUserDoesNotExist
  • string
ForbiddenUserInsufficientCapability
  • string
ForbiddenUserResource
  • string
ForbiddenUserSignupAllowanceExceeded
  • string
ForbiddenUserSignupDisabled
  • string
NoError
  • string
NotFound
  • string
NotFoundApimSubscription
  • string
NotFoundDomain
  • string
NotFoundImage
  • string
NotFoundInvalid
  • string
NotFoundIteration
  • string
NotFoundIterationPerformance
  • string
NotFoundProject
  • string
NotFoundProjectDefaultIteration
  • string
NotFoundTag
  • string
UnsupportedMediaType
  • string

ImagePerformance

Bildleistungsmodell.

Name Type Description
created
  • string
height
  • integer
id
  • string
imageUri
  • string
predictions

Vorhersageergebnis.

regions
tags
thumbnailUri
  • string
width
  • integer

ImageRegion

Name Type Description
created
  • string
height
  • number

Höhe.

left
  • number

Koordinate der linken Grenze.

regionId
  • string
tagId
  • string

ID des Tags, das dieser Region zugeordnet ist.

tagName
  • string
top
  • number

Koordinate der oberen Grenze.

width
  • number

Breite.

ImageTag

Name Type Description
created
  • string
tagId
  • string
tagName
  • string

Prediction

Vorhersageergebnis.

Name Type Description
boundingBox

Begrenzungsfeld der Vorhersage.

probability
  • number

Wahrscheinlichkeit des Tags.

tagId
  • string

ID des vorhergesagten Tags.

tagName
  • string

Name des vorhergesagten Tags.

tagType

Typ des vorhergesagten Tags.

TagType

Typ des vorhergesagten Tags.

Name Type Description
GeneralProduct
  • string
Negative
  • string
Regular
  • string