Predictions - Query

Servizio:

Azure AI Services

Versione API:

3.3

Ottenere le immagini inviate all'endpoint di stima.

POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/predictions/query

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati.
projectId	path	True	string (uuid)	ID progetto.

Intestazione della richiesta

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nome	Necessario	Tipo	Descrizione
Training-Key	True	string

Corpo della richiesta

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Nome	Tipo	Descrizione
application	string
continuation	string
endTime	string (date-time)
iterationId	string (uuid)
maxCount	integer (int32)
orderBy	OrderBy
session	string
startTime	string (date-time)
tags	PredictionQueryTag[]

Risposte

Nome	Tipo	Descrizione
200 OK	PredictionQueryResult	Va bene Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	Risposta di errore Media Types: "application/json", "application/xml", "text/xml"

Sicurezza

Training-Key

Tipo: apiKey
In: header

Esempio

Successful QueryPredictions request

Esempio di richiesta

HTTP

POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/bc3f7dad-5544-468c-8573-3ef04d55463e/predictions/query


{
  "orderBy": "Newest",
  "tags": [
    {
      "id": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
      "maxThreshold": 1,
      "minThreshold": 0.9
    }
  ]
}

Risposta di esempio

Codice di stato:

200

{
  "results": [
    {
      "id": "dfd2d346-3ed5-4e1e-857d-af4e32cec042",
      "project": "8988643a-ae70-447d-9a22-15c4255e5ecb",
      "iteration": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
      "created": "2018-01-31T20:18:26Z",
      "predictions": [
        {
          "tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
          "tagName": "Tag 1",
          "probability": 1
        },
        {
          "tagId": "45619cda-d1c9-4bc8-a3e1-87c5d81adbc3",
          "tagName": "Tag 2",
          "probability": 3.60627153E-12
        }
      ],
      "originalImageUri": "<image uri>",
      "thumbnailUri": "<thumbnail uri>",
      "resizedImageUri": "<resized image uri>",
      "domain": "b30a91ae-e3c1-4f73-a81e-c270bff27c39"
    }
  ],
  "token": {
    "session": "1:286613",
    "continuation": "",
    "maxCount": 0,
    "orderBy": "Newest",
    "tags": [
      {
        "id": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
        "minThreshold": 0.9,
        "maxThreshold": 1
      }
    ],
    "iterationId": null,
    "startTime": null,
    "endTime": null,
    "application": ""
  }
}

Definizioni

Nome	Descrizione
BoundingBox	Rettangolo di selezione che definisce un'area di un'immagine.
CustomVisionError
CustomVisionErrorCodes	Codice di errore.
OrderBy
Prediction	Risultato della stima.
PredictionQueryResult	Risultato della query delle immagini di stima inviate all'endpoint di stima.
PredictionQueryTag
PredictionQueryToken
StoredImagePrediction	Risultato di una richiesta di stima dell'immagine.
TagType	Tipo del tag stimato.

BoundingBox

Object

Rettangolo di selezione che definisce un'area di un'immagine.

Nome	Tipo	Descrizione
height	number (float)	Altezza.
left	number (float)	Coordinata del limite sinistro.
top	number (float)	Coordinata del limite superiore.
width	number (float)	Larghezza.

CustomVisionError

Object

Nome	Tipo	Descrizione
code	CustomVisionErrorCodes	Codice di errore.
message	string	Messaggio che spiega l'errore segnalato dal servizio.

CustomVisionErrorCodes

Enumerazione

Codice di errore.

Valore	Descrizione
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

OrderBy

Enumerazione

Valore	Descrizione
Newest
Oldest
Suggested

Prediction

Object

Risultato della stima.

Nome	Tipo	Descrizione
boundingBox	BoundingBox	Rettangolo di selezione della stima.
probability	number (float)	Probabilità del tag.
tagId	string (uuid)	ID del tag stimato.
tagName	string	Nome del tag stimato.
tagType	TagType	Tipo del tag stimato.

PredictionQueryResult

Object

Risultato della query delle immagini di stima inviate all'endpoint di stima.

Nome	Tipo	Descrizione
results	StoredImagePrediction[]	Risultato di una richiesta di stima dell'immagine.
token	PredictionQueryToken	Token di query di stima.

PredictionQueryTag

Object

Nome	Tipo	Descrizione
id	string (uuid)
maxThreshold	number (float)
minThreshold	number (float)

PredictionQueryToken

Object

Nome	Tipo	Descrizione
application	string
continuation	string
endTime	string (date-time)
iterationId	string (uuid)
maxCount	integer (int32)
orderBy	OrderBy
session	string
startTime	string (date-time)
tags	PredictionQueryTag[]

StoredImagePrediction

Object

Risultato di una richiesta di stima dell'immagine.

Nome	Tipo	Descrizione
created	string (date-time)	Data di creazione di questa stima.
domain	string (uuid)	Dominio usato per la stima.
id	string (uuid)	ID stima.
iteration	string (uuid)	ID iterazione.
originalImageUri	string	URI dell'immagine di stima originale. Se la funzionalità di rete virtuale è abilitata, si tratta di un percorso relativo da usare con GetArtifact. In caso contrario, si tratta di un URI assoluto per la risorsa.
predictions	Prediction[]	Elenco delle stime.
project	string (uuid)	ID progetto.
resizedImageUri	string	URI dell'immagine di stima (ridimensionata). Se la funzionalità di rete virtuale è abilitata, si tratta di un percorso relativo da usare con GetArtifact. In caso contrario, si tratta di un URI assoluto per la risorsa.
thumbnailUri	string	URI per l'anteprima dell'immagine di stima originale. Se la funzionalità di rete virtuale è abilitata, si tratta di un percorso relativo da usare con GetArtifact. In caso contrario, si tratta di un URI assoluto per la risorsa.

TagType

Enumerazione

Tipo del tag stimato.

Valore	Descrizione
GeneralProduct
Negative
Regular