Partager via

Projects - Quick Test Image

  • Référence
Service:
Azure AI Services
Version d'API:
3.3

Teste rapidement une image.

POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/quicktest/image
Avec des paramètres facultatifs: 
POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/quicktest/image?iterationId={iterationId}&store={store}

Paramètres URI

Nom Dans Obligatoire Type Description
imageData
 formData True

file

Données d’image binaires. Les formats pris en charge sont JPEG, GIF, PNG et BMP. Prend en charge les images jusqu’à 6 Mo.
Endpoint
 path True

string

Points de terminaison Cognitive Services pris en charge.
projectId
 path True

string (uuid)

ID du projet.
iterationId
 query

string (uuid)

Optionnel. Spécifie l’ID d’une itération particulière à évaluer.

        The default iteration for the project will be used when not specified.
store
 query

boolean

Optionnel. Spécifie s’il faut stocker ou non le résultat de cette prédiction. La valeur par défaut est true, à stocker.

En-tête de la demande

Media Types: "multipart/form-data", "application/octet-stream"

Nom Obligatoire Type Description
Training-Key True

string

Réponses

Nom Type Description
200 OK

ImagePrediction

D’ACCORD

Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes

CustomVisionError

Réponse d’erreur

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

Sécurité

Training-Key

Type: apiKey
Dans: header

Exemples

Successful QuickTestImage request

Exemple de requête

POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/quicktest/image?iterationId=fe1e83c4-6f50-4899-9544-6bb08cf0e15a

Exemple de réponse

Code d’état:
200 
{
  "id": "951098b2-9b69-427b-bddb-d5cb618874e3",
  "project": "64b822c5-8082-4b36-a426-27225f4aa18c",
  "iteration": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
  "created": "2017-12-19T14:21:41Z",
  "predictions": [
    {
      "tagId": "e31ff107-5505-4753-be42-b369b21b026c",
      "tagName": "Hemlock",
      "probability": 0.05149666
    },
    {
      "tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a",
      "tagName": "Japanese Cherry",
      "probability": 0
    }
  ]
}

Définitions

Nom Description
BoundingBox

Cadre englobant qui définit une région d’une image.
CustomVisionError
CustomVisionErrorCodes

Code d’erreur.
ImagePrediction

Résultat d’une demande de prédiction d’image.
Prediction

Résultat de prédiction.
TagType

Type de la balise prédite.

BoundingBox

Object

Cadre englobant qui définit une région d’une image.

Nom Type Description
height

number (float)

Hauteur.
left

number (float)

Coordonnée de la limite gauche.
top

number (float)

Coordonnée de la limite supérieure.
width

number (float)

Largeur.

CustomVisionError

Object
Nom Type Description
code

CustomVisionErrorCodes

Code d’erreur.
message

string

Message expliquant l’erreur signalée par le service.

CustomVisionErrorCodes

Énumération

Code d’erreur.

Valeur 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

ImagePrediction

Object

Résultat d’une demande de prédiction d’image.

Nom Type Description
created

string (date-time)

Date de création de cette prédiction.
id

string (uuid)

ID de prédiction.
iteration

string (uuid)

ID d’itération.
predictions

Prediction[]

Liste des prédictions.
project

string (uuid)

ID de projet.

Prediction

Object

Résultat de prédiction.

Nom Type Description
boundingBox

BoundingBox

Cadre englobant de la prédiction.
probability

number (float)

Probabilité de la balise.
tagId

string (uuid)

ID de la balise prédite.
tagName

string

Nom de la balise prédite.
tagType

TagType

Type de la balise prédite.

TagType

Énumération

Type de la balise prédite.

Valeur Description
GeneralProduct
Negative
Regular