Compartir a través de


Iterations - List Performance Images

Obtenga la imagen con su predicción para una iteración de proyecto determinada. Esta API admite el procesamiento por lotes y la selección de intervalos. De forma predeterminada, solo devolverá las primeras 50 imágenes coincidentes. Use los parámetros {take} y {skip} para controlar el número de imágenes que se van a devolver en un lote determinado. El filtrado está en una relación o . Por ejemplo, si los identificadores de etiqueta proporcionados son para las etiquetas "Dog" y "Cat", solo se devolverán imágenes etiquetadas con Dog o 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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
Endpoint
path True

string

Puntos de conexión de Cognitive Services admitidos.

iterationId
path True

string (uuid)

Identificador de iteración. El valor predeterminado es el área de trabajo.

projectId
path True

string (uuid)

Identificador del proyecto.

orderBy
query

string

La ordenación. El valor predeterminado es el más reciente.

skip
query

integer (int32)

Número de imágenes que se omitirán antes de comenzar el lote de imágenes. El valor predeterminado es 0.

tagIds
query

string[]

Lista de identificadores de etiquetas para filtrar las imágenes. El valor predeterminado es todas las imágenes etiquetadas cuando es NULL. Limitado a 20.

take
query

integer (int32)

minimum: 0
maximum: 256

Número máximo de imágenes que se van a devolver. El valor predeterminado es 50, limitado a 256.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Training-Key True

string

Respuestas

Nombre Tipo Description
200 OK

ImagePerformance[]

De acuerdo

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

Other Status Codes

CustomVisionError

Respuesta de error

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

Seguridad

Training-Key

Tipo: apiKey
En: header

Ejemplos

Successful GetImagePerformances request

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
BoundingBox

Rectángulo de límite que define una región de una imagen.

CustomVisionError
CustomVisionErrorCodes

Código de error.

ImagePerformance

Modelo de rendimiento de imágenes.

ImageRegion
ImageTag
Prediction

Resultado de la predicción.

TagType

Tipo de la etiqueta predicha.

BoundingBox

Rectángulo de límite que define una región de una imagen.

Nombre Tipo Description
height

number (float)

Altura.

left

number (float)

Coordenada del límite izquierdo.

top

number (float)

Coordenada del límite superior.

width

number (float)

Ancho.

CustomVisionError

Nombre Tipo Description
code

CustomVisionErrorCodes

Código de error.

message

string

Mensaje que explica el error notificado por el servicio.

CustomVisionErrorCodes

Código de error.

Valor 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

Modelo de rendimiento de imágenes.

Nombre Tipo Description
created

string (date-time)

height

integer (int32)

id

string (uuid)

imageUri

string

predictions

Prediction[]

Resultado de la predicción.

regions

ImageRegion[]

tags

ImageTag[]

thumbnailUri

string

width

integer (int32)

ImageRegion

Nombre Tipo Description
created

string (date-time)

height

number (float)

Altura.

left

number (float)

Coordenada del límite izquierdo.

regionId

string (uuid)

tagId

string (uuid)

Identificador de la etiqueta asociada a esta región.

tagName

string

top

number (float)

Coordenada del límite superior.

width

number (float)

Ancho.

ImageTag

Nombre Tipo Description
created

string (date-time)

tagId

string (uuid)

tagName

string

Prediction

Resultado de la predicción.

Nombre Tipo Description
boundingBox

BoundingBox

Rectángulo delimitador de la predicción.

probability

number (float)

Probabilidad de la etiqueta.

tagId

string (uuid)

Identificador de la etiqueta predicha.

tagName

string

Nombre de la etiqueta de predicción.

tagType

TagType

Tipo de la etiqueta predicha.

TagType

Tipo de la etiqueta predicha.

Valor Description
GeneralProduct
Negative
Regular