Predictions - Query

Referenz

Dienst:: Azure AI Services

API-Version:: 3.3

Ruft Bilder ab, die an Ihren Vorhersageendpunkt gesendet wurden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte.
projectId	path	True	string (uuid)	Die Projekt-ID.

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
Training-Key	True	string

Anforderungstext

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

Name	Typ	Beschreibung
application	string
continuation	string
endTime	string (date-time)
iterationId	string (uuid)
maxCount	integer (int32)
orderBy	OrderBy
session	string
startTime	string (date-time)
tags	PredictionQueryTag[]

Antworten

Name	Typ	Beschreibung
200 OK	PredictionQueryResult	OKAY Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	Fehlerantwort Media Types: "application/json", "application/xml", "text/xml"

Name

Typ

Beschreibung

200 OK

PredictionQueryResult

OKAY

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

Other Status Codes

CustomVisionError

Fehlerantwort

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

Sicherheit

Training-Key

Typ: apiKey
In: header

Beispiele

Successful QueryPredictions request

Beispielanforderung

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
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 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": ""
  }
}

Definitionen

Name	Beschreibung
BoundingBox	Umgebendes Feld, das einen Bereich eines Bilds definiert.
CustomVisionError
CustomVisionErrorCodes	Der Fehlercode.
OrderBy
Prediction	Vorhersageergebnis.
PredictionQueryResult	Abfrageergebnis der Vorhersagebilder, die an Ihren Vorhersageendpunkt gesendet wurden.
PredictionQueryTag
PredictionQueryToken
StoredImagePrediction	Ergebnis einer Bildvorhersageanforderung.
TagType	Typ des vorhergesagten Tags.

BoundingBox

Objekt

Umgebendes Feld, das einen Bereich eines Bilds definiert.

Name	Typ	Beschreibung
height	number (float)	Höhe.
left	number (float)	Koordinate der linken Grenze.
top	number (float)	Koordinate der oberen Grenze.
width	number (float)	Breite.

CustomVisionError

Objekt

Name	Typ	Beschreibung
code	CustomVisionErrorCodes	Der Fehlercode.
message	string	Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.

CustomVisionErrorCodes

Enumeration

Der Fehlercode.

Wert	Beschreibung
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

Enumeration

Wert	Beschreibung
Newest
Oldest
Suggested

Prediction

Objekt

Vorhersageergebnis.

Name	Typ	Beschreibung
boundingBox	BoundingBox	Umgebendes Feld der Vorhersage.
probability	number (float)	Wahrscheinlichkeit des Tags.
tagId	string (uuid)	ID des vorhergesagten Tags.
tagName	string	Name des vorhergesagten Tags.
tagType	TagType	Typ des vorhergesagten Tags.

PredictionQueryResult

Objekt

Abfrageergebnis der Vorhersagebilder, die an Ihren Vorhersageendpunkt gesendet wurden.

Name	Typ	Beschreibung
results	StoredImagePrediction[]	Ergebnis einer Bildvorhersageanforderung.
token	PredictionQueryToken	Vorhersageabfragetoken.

PredictionQueryTag

Objekt

Name	Typ	Beschreibung
id	string (uuid)
maxThreshold	number (float)
minThreshold	number (float)

PredictionQueryToken

Objekt

Name	Typ	Beschreibung
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

Objekt

Ergebnis einer Bildvorhersageanforderung.

Name	Typ	Beschreibung
created	string (date-time)	Datum, an dem diese Vorhersage erstellt wurde.
domain	string (uuid)	Domäne, die für die Vorhersage verwendet wird.
id	string (uuid)	Vorhersage-ID.
iteration	string (uuid)	Iterations-ID.
originalImageUri	string	Der URI für das ursprüngliche Vorhersagebild. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.
predictions	Prediction[]	Liste der Vorhersagen.
project	string (uuid)	Projekt-ID.
resizedImageUri	string	Der URI für das (verkleinerte) Vorhersagebild. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.
thumbnailUri	string	Der URI zur Miniaturansicht des ursprünglichen Vorhersagebilds. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.

TagType

Enumeration

Typ des vorhergesagten Tags.

Wert	Beschreibung
GeneralProduct
Negative
Regular

Freigeben über

Predictions - Query

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

Training-Key

Beispiele

Successful QueryPredictions request

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BoundingBox

CustomVisionError

CustomVisionErrorCodes

OrderBy

Prediction

PredictionQueryResult

PredictionQueryTag

PredictionQueryToken

StoredImagePrediction

TagType

Zusätzliche Ressourcen