Image Classifier - Classify Image
Klasifikuje obrázek a uloží výsledek.
POST {Endpoint}/customvision/v3.1/prediction/{projectId}/classify/iterations/{publishedName}/image
POST {Endpoint}/customvision/v3.1/prediction/{projectId}/classify/iterations/{publishedName}/image?application={application}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
image
|
formData | True |
file |
Binární data obrázku. Podporované formáty jsou JPEG, GIF, PNG a BMP. Podporuje image až 4 MB. |
Endpoint
|
path | True |
string |
Podporované koncové body služeb Cognitive Services. |
project
|
path | True |
string uuid |
ID projektu. |
published
|
path | True |
string |
Určuje název modelu, který se má vyhodnotit. |
application
|
query |
string |
Nepovinný parametr. Určuje název aplikace používající koncový bod. |
Hlavička požadavku
Media Types: "multipart/form-data", "application/octet-stream"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
Prediction-Key | True |
string |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK Media Types: "application/json", "application/xml", "text/xml" |
|
Other Status Codes |
Odpověď na chybu Media Types: "application/json", "application/xml", "text/xml" |
Zabezpečení
Prediction-Key
Type:
apiKey
In:
header
Příklady
Successful ClassifyImage request
Sample Request
POST https://westus.api.cognitive.microsoft.com/customvision/v3.1/prediction/64b822c5-8082-4b36-a426-27225f4aa18c/classify/iterations/MyModel1/image
Sample Response
{
"id": "951098b2-9b69-427b-bddb-d5cb618874e3",
"project": "64b822c5-8082-4b36-a426-27225f4aa18c",
"iteration": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
"created": "2019-03-06T02:15:00Z",
"predictions": [
{
"tagId": "e31ff107-5505-4753-be42-b369b21b026c",
"tagName": "Hemlock",
"probability": 0.05149666
},
{
"tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a",
"tagName": "Japanese Cherry",
"probability": 0.000193528482
}
]
}
Definice
Name | Description |
---|---|
Bounding |
Ohraničující rámeček, který definuje oblast obrázku. |
Custom |
|
Custom |
Kód chyby |
Image |
Výsledek požadavku na predikci obrázku |
Prediction |
Výsledek předpovědi. |
Tag |
Typ predikované značky |
BoundingBox
Ohraničující rámeček, který definuje oblast obrázku.
Name | Typ | Description |
---|---|---|
height |
number |
Výška. |
left |
number |
Souřadnice levého ohraničení. |
top |
number |
Souřadnice horní hranice. |
width |
number |
Šířka. |
CustomVisionError
Name | Typ | Description |
---|---|---|
code |
Kód chyby |
|
message |
string |
Zpráva vysvětlující chybu nahlášenou službou. |
CustomVisionErrorCodes
Kód chyby
Name | Typ | Description |
---|---|---|
BadRequest |
string |
|
BadRequestCannotMigrateProjectWithName |
string |
|
BadRequestClassificationTrainingValidationFailed |
string |
|
BadRequestCustomerManagedKeyRevoked |
string |
|
BadRequestDetectionTrainingNotAllowNegativeTag |
string |
|
BadRequestDetectionTrainingValidationFailed |
string |
|
BadRequestDomainNotSupportedForAdvancedTraining |
string |
|
BadRequestExceedIterationPerProjectLimit |
string |
|
BadRequestExceedProjectLimit |
string |
|
BadRequestExceedTagPerImageLimit |
string |
|
BadRequestExceedTagPerProjectLimit |
string |
|
BadRequestExceededBatchSize |
string |
|
BadRequestExceededQuota |
string |
|
BadRequestExportAlreadyInProgress |
string |
|
BadRequestExportPlatformNotSupportedForAdvancedTraining |
string |
|
BadRequestExportValidationFailed |
string |
|
BadRequestExportWhileTraining |
string |
|
BadRequestImageBatch |
string |
|
BadRequestImageDimensions |
string |
|
BadRequestImageExceededCount |
string |
|
BadRequestImageFormat |
string |
|
BadRequestImageMetadataKey |
string |
|
BadRequestImageMetadataValue |
string |
|
BadRequestImageRegions |
string |
|
BadRequestImageSizeBytes |
string |
|
BadRequestImageStream |
string |
|
BadRequestImageTags |
string |
|
BadRequestImageUrl |
string |
|
BadRequestInvalid |
string |
|
BadRequestInvalidArtifactUri |
string |
|
BadRequestInvalidEmailAddress |
string |
|
BadRequestInvalidIds |
string |
|
BadRequestInvalidImportToken |
string |
|
BadRequestInvalidPublishName |
string |
|
BadRequestInvalidPublishTarget |
string |
|
BadRequestIterationDescription |
string |
|
BadRequestIterationIsNotTrained |
string |
|
BadRequestIterationIsPublished |
string |
|
BadRequestIterationName |
string |
|
BadRequestIterationNameNotUnique |
string |
|
BadRequestIterationNotPublished |
string |
|
BadRequestIterationValidationFailed |
string |
|
BadRequestMultiClassClassificationTrainingValidationFailed |
string |
|
BadRequestMultiLabelClassificationTrainingValidationFailed |
string |
|
BadRequestMultipleGeneralProductTag |
string |
|
BadRequestMultipleNegativeTag |
string |
|
BadRequestNegativeAndRegularTagOnSameImage |
string |
|
BadRequestNotLimitedTrial |
string |
|
BadRequestNotSupported |
string |
|
BadRequestOperationNotSupported |
string |
|
BadRequestPredictionIdsExceededCount |
string |
|
BadRequestPredictionIdsMissing |
string |
|
BadRequestPredictionInvalidApplicationName |
string |
|
BadRequestPredictionInvalidQueryParameters |
string |
|
BadRequestPredictionResultsExceededCount |
string |
|
BadRequestPredictionTagsExceededCount |
string |
|
BadRequestProjectDescription |
string |
|
BadRequestProjectDuplicated |
string |
|
BadRequestProjectImagePreprocessingSettings |
string |
|
BadRequestProjectName |
string |
|
BadRequestProjectNameNotUnique |
string |
|
BadRequestProjectUnknownClassification |
string |
|
BadRequestProjectUnknownDomain |
string |
|
BadRequestProjectUnsupportedDomainTypeChange |
string |
|
BadRequestProjectUnsupportedExportPlatform |
string |
|
BadRequestRequiredParamIsNull |
string |
|
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining |
string |
|
BadRequestSubscriptionApi |
string |
|
BadRequestTagDescription |
string |
|
BadRequestTagName |
string |
|
BadRequestTagNameNotUnique |
string |
|
BadRequestTagType |
string |
|
BadRequestTrainingAlreadyInProgress |
string |
|
BadRequestTrainingNotNeeded |
string |
|
BadRequestTrainingNotNeededButTrainingPipelineUpdated |
string |
|
BadRequestTrainingValidationFailed |
string |
|
BadRequestUnpublishFailed |
string |
|
BadRequestUnsupportedDomain |
string |
|
BadRequestWorkspaceCannotBeModified |
string |
|
BadRequestWorkspaceNotDeletable |
string |
|
Conflict |
string |
|
ConflictInvalid |
string |
|
ErrorExporterInvalidClassifier |
string |
|
ErrorExporterInvalidFeaturizer |
string |
|
ErrorExporterInvalidPlatform |
string |
|
ErrorFeaturizationAugmentationError |
string |
|
ErrorFeaturizationAugmentationUnavailable |
string |
|
ErrorFeaturizationInvalidFeaturizer |
string |
|
ErrorFeaturizationQueueTimeout |
string |
|
ErrorFeaturizationServiceUnavailable |
string |
|
ErrorFeaturizationUnrecognizedJob |
string |
|
ErrorInvalid |
string |
|
ErrorIterationCopyFailed |
string |
|
ErrorPrediction |
string |
|
ErrorPredictionModelNotCached |
string |
|
ErrorPredictionModelNotFound |
string |
|
ErrorPredictionServiceUnavailable |
string |
|
ErrorPredictionStorage |
string |
|
ErrorPreparePerformanceMigrationFailed |
string |
|
ErrorProjectExportRequestFailed |
string |
|
ErrorProjectImportRequestFailed |
string |
|
ErrorProjectInvalidDomain |
string |
|
ErrorProjectInvalidPipelineConfiguration |
string |
|
ErrorProjectInvalidWorkspace |
string |
|
ErrorProjectTrainingRequestFailed |
string |
|
ErrorRegionProposal |
string |
|
ErrorUnknown |
string |
|
ErrorUnknownBaseModel |
string |
|
Forbidden |
string |
|
ForbiddenDRModeEnabled |
string |
|
ForbiddenInvalid |
string |
|
ForbiddenUser |
string |
|
ForbiddenUserDisabled |
string |
|
ForbiddenUserDoesNotExist |
string |
|
ForbiddenUserInsufficientCapability |
string |
|
ForbiddenUserResource |
string |
|
ForbiddenUserSignupAllowanceExceeded |
string |
|
ForbiddenUserSignupDisabled |
string |
|
NoError |
string |
|
NotFound |
string |
|
NotFoundApimSubscription |
string |
|
NotFoundDomain |
string |
|
NotFoundImage |
string |
|
NotFoundInvalid |
string |
|
NotFoundIteration |
string |
|
NotFoundIterationPerformance |
string |
|
NotFoundProject |
string |
|
NotFoundProjectDefaultIteration |
string |
|
NotFoundTag |
string |
|
UnsupportedMediaType |
string |
ImagePrediction
Výsledek požadavku na predikci obrázku
Name | Typ | Description |
---|---|---|
created |
string |
Datum vytvoření této předpovědi |
id |
string |
ID předpovědi. |
iteration |
string |
ID iterace. |
predictions |
Seznam předpovědí. |
|
project |
string |
ID projektu. |
Prediction
Výsledek předpovědi.
Name | Typ | Description |
---|---|---|
boundingBox |
Ohraničující rámeček předpovědi. |
|
probability |
number |
Pravděpodobnost značky. |
tagId |
string |
ID predikované značky. |
tagName |
string |
Název predikované značky. |
tagType |
Typ predikované značky |
TagType
Typ predikované značky
Name | Typ | Description |
---|---|---|
GeneralProduct |
string |
|
Negative |
string |
|
Regular |
string |