Iterations - List Performance Images

Usługa:

Azure AI Services

Wersja interfejsu API:

3.3

Pobierz obraz z przewidywaniem dla danej iteracji projektu. Ten interfejs API obsługuje przetwarzanie wsadowe i wybór zakresu. Domyślnie będzie zwracać tylko pierwsze 50 obrazów pasujących do obrazów. Użyj parametrów {take} i {skip}, aby kontrolować liczbę obrazów, które mają być zwracane w danej partii. Filtrowanie jest w relacji i/lub. Jeśli na przykład podane identyfikatory tagów są przeznaczone dla tagów "Dog" i "Cat", zostaną zwrócone tylko obrazy oznaczone tagiem Dog i/lub Cat

GET {Endpoint}/customvision/v3.3/training/projects/{projectId}/iterations/{iterationId}/performance/images

Z parametrami opcjonalnymi:

GET {Endpoint}/customvision/v3.3/training/projects/{projectId}/iterations/{iterationId}/performance/images?tagIds={tagIds}&orderBy={orderBy}&take={take}&skip={skip}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services.
iterationId	path	True	string (uuid)	Identyfikator iteracji. Domyślnie jest to obszar roboczy.
projectId	path	True	string (uuid)	Identyfikator projektu.
orderBy	query		string	Kolejność. Wartości domyślne do najnowszych.
skip	query		integer (int32)	Liczba obrazów do pominięcia przed rozpoczęciem partii obrazów. Wartość domyślna to 0.
tagIds	query		string[]	Lista identyfikatorów tagów do filtrowania obrazów. Domyślnie wszystkie oznakowane obrazy mają wartość null. Ograniczone do 20.
take	query		integer (int32) minimum: 0 maximum: 256	Maksymalna liczba obrazów do zwrócenia. Wartość domyślna to 50, ograniczona do 256.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Training-Key	True	string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ImagePerformance[]	OK Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	Odpowiedź na błąd Media Types: "application/json", "application/xml", "text/xml"

Zabezpieczenia

Training-Key

Typ: apiKey
W: header

Przykłady

Successful GetImagePerformances request

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

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

Definicje

Nazwa	Opis
BoundingBox	Pole ograniczenia definiujące region obrazu.
CustomVisionError
CustomVisionErrorCodes	Kod błędu.
ImagePerformance	Model wydajności obrazu.
ImageRegion
ImageTag
Prediction	Wynik przewidywania.
TagType	Typ przewidywanego tagu.

BoundingBox

Objekt

Pole ograniczenia definiujące region obrazu.

Nazwa	Typ	Opis
height	number (float)	Wysokość.
left	number (float)	Współrzędna lewej granicy.
top	number (float)	Współrzędna górnej granicy.
width	number (float)	Szerokość.

CustomVisionError

Objekt

Nazwa	Typ	Opis
code	CustomVisionErrorCodes	Kod błędu.
message	string	Komunikat wyjaśniający błąd zgłoszony przez usługę.

CustomVisionErrorCodes

Wyliczanie

Kod błędu.

Wartość	Opis
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

Objekt

Model wydajności obrazu.

Nazwa	Typ	Opis
created	string (date-time)
height	integer (int32)
id	string (uuid)
imageUri	string
predictions	Prediction[]	Wynik przewidywania.
regions	ImageRegion[]
tags	ImageTag[]
thumbnailUri	string
width	integer (int32)

ImageRegion

Objekt

Nazwa	Typ	Opis
created	string (date-time)
height	number (float)	Wysokość.
left	number (float)	Współrzędna lewej granicy.
regionId	string (uuid)
tagId	string (uuid)	Identyfikator tagu skojarzonego z tym regionem.
tagName	string
top	number (float)	Współrzędna górnej granicy.
width	number (float)	Szerokość.

ImageTag

Objekt

Nazwa	Typ	Opis
created	string (date-time)
tagId	string (uuid)
tagName	string

Prediction

Objekt

Wynik przewidywania.

Nazwa	Typ	Opis
boundingBox	BoundingBox	Pole ograniczenia przewidywania.
probability	number (float)	Prawdopodobieństwo tagu.
tagId	string (uuid)	Identyfikator przewidywanego tagu.
tagName	string	Nazwa przewidywanego tagu.
tagType	TagType	Typ przewidywanego tagu.

TagType

Wyliczanie

Typ przewidywanego tagu.

Wartość	Opis
GeneralProduct
Negative
Regular