Create Image Regions - Create Image Regions

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: 3.4-preview

Hozzon létre egy képrégiócsoportot.
Ez az API egy köteg képrégiót és opcionálisan címkéket fogad el a meglévő lemezképek régióinformációkkal való frissítéséhez. A kötegben legfeljebb 64 bejegyzés szerepel. Ha minden régió sikeresen létrejött, a rendszer 200(OK) állapotkódot ad vissza. Ellenkező esetben a rendszer visszaadja a 207(többállapotú) állapotkódot, és az egyes régiók részletes állapota megjelenik a válasz hasznos adatai között.

POST {Endpoint}/customvision/v3.4-preview/training/projects/{projectId}/images/regions

URI-paraméterek

Name	In	Kötelező	Típus	Description
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok.
projectId	path	True	string (uuid)	A projekt azonosítója.

Kérelem fejléce

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

Name	Kötelező	Típus	Description
Training-Key	True	string

Kérelem törzse

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

Name	Típus	Description
regions	ImageRegionCreateEntry[]	A bejegyzés egy régiót társít egy képhez.

Válaszok

Name	Típus	Description
200 OK	ImageRegionCreateSummary	OKÉ Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	ImageRegionCreateSummary	207 Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	CustomVisionError	Hibaválasz Media Types: "application/json", "application/xml", "text/xml"

Name

Típus

Description

200 OK

ImageRegionCreateSummary

OKÉ

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

Other Status Codes

ImageRegionCreateSummary

207

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

Other Status Codes

CustomVisionError

Hibaválasz

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

Biztonság

Training-Key

Típus: apiKey
In: header

Példák

Successful CreateImageRegions request

Mintakérelem

HTTP

POST https://westus.api.cognitive.microsoft.com/customvision/v3.4-preview/training/projects/bc3f7dad-5544-468c-8573-3ef04d55463e/images/regions


{
  "regions": [
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.25,
      "top": 0.25,
      "width": 0.25,
      "height": 0.25
    },
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.35,
      "top": 0.35,
      "width": 0.25,
      "height": 0.25
    }
  ]
}

Mintaválasz

Állapotkód:: 200

{
  "created": [
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.25,
      "top": 0.25,
      "width": 0.25,
      "height": 0.25
    },
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.35,
      "top": 0.35,
      "width": 0.25,
      "height": 0.25
    }
  ],
  "duplicated": [],
  "exceeded": []
}

Állapotkód:: 207

{
  "created": [
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.25,
      "top": 0.25,
      "width": 0.25,
      "height": 0.25
    }
  ],
  "duplicated": [],
  "exceeded": [
    {
      "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
      "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
      "left": 0.35,
      "top": 0.35,
      "width": 0.25,
      "height": 0.25
    }
  ]
}

Definíciók

Name	Description
CustomVisionError
CustomVisionErrorCodes	A hibakód.
ImageRegionCreateBatch	Létrehozandó képrégió-információk kötege.
ImageRegionCreateEntry	A bejegyzés egy régiót társít egy képhez.
ImageRegionCreateResult
ImageRegionCreateSummary

CustomVisionError

Objektum

Name	Típus	Description
code	CustomVisionErrorCodes	A hibakód.
message	string	A szolgáltatás által jelentett hibát magyarázó üzenet.

CustomVisionErrorCodes

Enumerálás

A hibakód.

Érték	Description
BadRequest
BadRequestCannotMigrateProjectWithName
BadRequestClassificationTrainingValidationFailed
BadRequestCustomBaseModelArchitectureRetired
BadRequestCustomBaseModelDomainNotCompatible
BadRequestCustomBaseModelIterationStatusNotCompleted
BadRequestCustomerManagedKeyRevoked
BadRequestDetectionTrainingNotAllowNegativeTag
BadRequestDetectionTrainingValidationFailed
BadRequestDomainNotSupportedForAdvancedTraining
BadRequestExceedIterationPerProjectLimit
BadRequestExceedProjectLimit
BadRequestExceedTagPerImageLimit
BadRequestExceedTagPerProjectLimit
BadRequestExceededBatchSize
BadRequestExceededQuota
BadRequestExportAlreadyInProgress
BadRequestExportPlatformNotSupportedForAdvancedTraining
BadRequestExportValidationFailed
BadRequestExportWhileTraining
BadRequestImageAspectRatio
BadRequestImageBatch
BadRequestImageDimensions
BadRequestImageExceededCount
BadRequestImageFormat
BadRequestImageMetadataKey
BadRequestImageMetadataValue
BadRequestImageRegions
BadRequestImageSizeBytes
BadRequestImageStream
BadRequestImageTags
BadRequestImageUrl
BadRequestInvalid
BadRequestInvalidArtifactUri
BadRequestInvalidEmailAddress
BadRequestInvalidIds
BadRequestInvalidImportToken
BadRequestInvalidPublishName
BadRequestInvalidPublishTarget
BadRequestInvalidUri
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
BadRequestRetiredDomainNotSupportedForTraining
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
ErrorServerTimeOut
ErrorUnknown
ErrorUnknownBaseModel
Forbidden
ForbiddenDRModeEnabled
ForbiddenInvalid
ForbiddenUser
ForbiddenUserDisabled
ForbiddenUserDoesNotExist
ForbiddenUserInsufficientCapability
ForbiddenUserResource
ForbiddenUserSignupAllowanceExceeded
ForbiddenUserSignupDisabled
NoError
NotFound
NotFoundApimSubscription
NotFoundDomain
NotFoundImage
NotFoundInvalid
NotFoundIteration
NotFoundIterationPerformance
NotFoundProject
NotFoundProjectDefaultIteration
NotFoundTag
UnsupportedMediaType

ImageRegionCreateBatch

Objektum

Létrehozandó képrégió-információk kötege.

Name	Típus	Description
regions	ImageRegionCreateEntry[]	A bejegyzés egy régiót társít egy képhez.

ImageRegionCreateEntry

Objektum

A bejegyzés egy régiót társít egy képhez.

Name	Típus	Description
height	number (float)	Magasság.
imageId	string (uuid)	A kép azonosítója.
left	number (float)	A bal oldali határ koordinátája.
tagId	string (uuid)	A régióhoz társított címke azonosítója.
top	number (float)	A felső határ koordinátája.
width	number (float)	Szélesség.

ImageRegionCreateResult

Objektum

Name	Típus	Description
created	string (date-time)
height	number (float)	Magasság.
imageId	string (uuid)
left	number (float)	A bal oldali határ koordinátája.
regionId	string (uuid)
tagId	string (uuid)	A régióhoz társított címke azonosítója.
tagName	string
top	number (float)	A felső határ koordinátája.
width	number (float)	Szélesség.

ImageRegionCreateSummary

Objektum

Name	Típus	Description
created	ImageRegionCreateResult[]
duplicated	ImageRegionCreateEntry[]	A bejegyzés egy régiót társít egy képhez.
exceeded	ImageRegionCreateEntry[]	A bejegyzés egy régiót társít egy képhez.

Megosztás a következőn keresztül:

Create Image Regions - Create Image Regions

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Biztonság

Training-Key

Példák

Successful CreateImageRegions request

Mintakérelem

Mintaválasz

Definíciók

CustomVisionError

CustomVisionErrorCodes

ImageRegionCreateBatch

ImageRegionCreateEntry

ImageRegionCreateResult

ImageRegionCreateSummary