您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Get Image Performances - Get Image Performances

获取图像及其对给定项目迭代的预测。
此 API 支持批处理和范围选择。 默认情况下,它只返回与图像匹配的前 50 个图像。 使用 {take} 和 {skip} 参数控制给定批中要返回的图像数。 筛选依据为某个字词和/或关系。 例如,如果提供的标记 ID 用于"Dog"和"Cat"标记,则仅返回使用 Dog 和/或 Cat 标记的图像

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 参数

Name In Required Type Description
Endpoint
path True
  • string

支持的认知服务终结点。

iterationId
path True
  • string
uuid

迭代 ID。默认为工作区。

projectId
path True
  • string
uuid

项目 ID。

orderBy
query
  • string

排序。 默认为最新。

skip
query
  • integer
int32

在开始映像批之前要跳过的图像数。 默认值为 0。

tagIds
query
  • array

用于筛选图像的标记 ID 列表。 如果为 null,则默认为所有标记的图像。 限制为 20。

take
query
  • integer
int32

要返回的最大图像数。 默认为 50,限制为 256。

请求头

Name Required Type Description
Training-Key True
  • string

响应

Name Type Description
200 OK

确定

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

Other Status Codes

错误响应

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

安全性

Training-Key

Type: apiKey
In: header

示例

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

定义

BoundingBox

定义图像区域边界框。

CustomVisionError
CustomVisionErrorCodes

错误代码。

ImagePerformance

图像性能模型。

ImageRegion
ImageTag
Prediction

预测结果。

TagType

预测标记的类型。

BoundingBox

定义图像区域边界框。

Name Type Description
height
  • number

高度。

left
  • number

左边界的坐标。

top
  • number

上边界的坐标。

width
  • number

宽度。

CustomVisionError

Name Type Description
code

错误代码。

message
  • string

一条消息,说明服务报告的错误。

CustomVisionErrorCodes

错误代码。

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

图像性能模型。

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

预测结果。

regions
tags
thumbnailUri
  • string
width
  • integer

ImageRegion

Name Type Description
created
  • string
height
  • number

高度。

left
  • number

左边界的坐标。

regionId
  • string
tagId
  • string

与此区域关联的标记的 ID。

tagName
  • string
top
  • number

上边界的坐标。

width
  • number

宽度。

ImageTag

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

Prediction

预测结果。

Name Type Description
boundingBox

预测边界框。

probability
  • number

标记的概率。

tagId
  • string

预测标记的 ID。

tagName
  • string

预测标记的名称。

tagType

预测标记的类型。

TagType

预测标记的类型。

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