Create Images From Data - Create Images From Data

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: 3.4-preview

Adja hozzá a megadott képeket a betanítási képek készletéhez.
Ez az API többrészes/űrlapadatokként és alkalmazás-/oktet-streamként fogadja el a törzstartalmakat. Többrészes képfájlok használata esetén egyszerre több képfájl is küldhető, legfeljebb 64 fájllal. Ha az összes kép létrehozása sikeres, a rendszer 200(OK) állapotkódot ad vissza. Ellenkező esetben a rendszer visszaadja a 207(többállapotú) állapotkódot, és az egyes képek részletes állapota megjelenik a válasz hasznos adatai között.

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

Opcionális paraméterekkel:

POST {Endpoint}/customvision/v3.4-preview/training/projects/{projectId}/images?tagIds={tagIds}

URI-paraméterek

Name	In	Kötelező	Típus	Description
imageData	formData	True	file	Bináris képadatok. A támogatott formátumok a JPEG, a GIF, a PNG és a BMP. Legfeljebb 6 MB méretű képeket támogat.
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok.
projectId	path	True	string (uuid)	A projekt azonosítója.
tagIds	query		string[]	Azok a címkék, amelyekkel az egyes képeket címkézni szeretné. Legfeljebb 20.

Kérelem fejléce

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

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

Válaszok

Name	Típus	Description
200 OK	ImageCreateSummary	OKÉ Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes	ImageCreateSummary	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

ImageCreateSummary

OKÉ

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

Other Status Codes

ImageCreateSummary

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 CreateImagesFromData request

Mintakérelem

HTTP

POST https://westus.api.cognitive.microsoft.com/customvision/v3.4-preview/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/images?tagIds=b607964f-7bd6-4a3b-a869-6791fb6aab87

Mintaválasz

Állapotkód:: 200

{
  "isBatchSuccessful": true,
  "images": [
    {
      "sourceUrl": "\"hemlock_10.jpg\"",
      "status": "OK",
      "image": {
        "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
        "created": "2017-12-19T15:56:10Z",
        "width": 1095,
        "height": 900,
        "resizedImageUri": "{Resized Image Uri}",
        "originalImageUri": "{Image Uri}",
        "thumbnailUri": "{Thumbnail Uri}",
        "tags": [
          {
            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
            "created": "2017-12-19T15:56:09Z",
            "tagName": "tag 1"
          }
        ]
      }
    },
    {
      "sourceUrl": "\"hemlock_6.jpg\"",
      "status": "OK",
      "image": {
        "id": "f1855a92-b873-47e7-b513-f07a667ceda1",
        "created": "2017-12-19T15:56:10Z",
        "width": 900,
        "height": 1531,
        "resizedImageUri": "{Resized Image Uri}",
        "originalImageUri": "{Image Uri}",
        "thumbnailUri": "{Thumbnail Uri}",
        "tags": [
          {
            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
            "created": "2017-12-19T15:56:09Z",
            "tagName": "tag 1"
          }
        ]
      }
    }
  ]
}

Állapotkód:: 207

{
  "isBatchSuccessful": false,
  "images": [
    {
      "sourceUrl": "\"hemlock_10.jpg\"",
      "status": "OK",
      "image": {
        "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
        "created": "2017-12-19T15:56:10Z",
        "width": 1095,
        "height": 900,
        "resizedImageUri": "{Resized Image Uri}",
        "originalImageUri": "{Image Uri}",
        "thumbnailUri": "{Thumbnail Uri}",
        "tags": [
          {
            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
            "created": "2017-12-19T15:56:09Z",
            "tagName": "tag 1"
          }
        ]
      }
    },
    {
      "sourceUrl": "\"hemlock_6.jpg\"",
      "status": "ErrorLimitExceed"
    }
  ]
}

Definíciók

Name	Description
CustomVisionError
CustomVisionErrorCodes	A hibakód.
Image	JSON-ként küldendő képmodell.
ImageCreateResult
ImageCreateStatus	A kép létrehozásának állapota.
ImageCreateSummary
ImageRegion
ImageTag

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

Image

Objektum

JSON-ként küldendő képmodell.

Name	Típus	Description
created	string (date-time)	A kép létrehozásának dátuma.
height	integer (int32)	A kép magassága.
id	string (uuid)	A kép azonosítója.
metadata	object	A képhez társított metaadatok.
originalImageUri	string	Az URI az eredeti feltöltött képre. Ha a VNET szolgáltatás engedélyezve van, ez egy relatív elérési út lesz, amelyet a GetArtifact használatával kell használni, ellenkező esetben ez az erőforrás abszolút URI-ja lesz.
regions	ImageRegion[]	A képhez társított régiók.
resizedImageUri	string	A betanításhoz használt (átméretezett) rendszerkép URI-ja. Ha a VNET szolgáltatás engedélyezve van, ez egy relatív elérési út lesz, amelyet a GetArtifact használatával kell használni, ellenkező esetben ez az erőforrás abszolút URI-ja lesz.
tags	ImageTag[]	A képhez társított címkék.
thumbnailUri	string	Az URI az eredeti kép miniatűrjére. Ha a VNET szolgáltatás engedélyezve van, ez egy relatív elérési út lesz, amelyet a GetArtifact használatával kell használni, ellenkező esetben ez az erőforrás abszolút URI-ja lesz.
width	integer (int32)	A kép szélessége.

ImageCreateResult

Objektum

Name	Típus	Description
image	Image	A kép.
sourceUrl	string	A kép forrás URL-címe.
status	ImageCreateStatus	A kép létrehozásának állapota.

ImageCreateStatus

Enumerálás

A kép létrehozásának állapota.

Érték	Description
ErrorImageDimensions
ErrorImageFormat
ErrorImageSize
ErrorInvalidTag
ErrorLimitExceed
ErrorNegativeAndRegularTagOnSameImage
ErrorRegionLimitExceed
ErrorSource
ErrorStorage
ErrorTagLimitExceed
ErrorUnknown
OK
OKDuplicate

ImageCreateSummary

Objektum

Name	Típus	Description
images	ImageCreateResult[]	A képlétrehozás eredményeinek listája.
isBatchSuccessful	boolean	Igaz, ha a köteg összes képe sikeresen létrejött, egyébként hamis.

ImageRegion

Objektum

Name	Típus	Description
created	string (date-time)
height	number (float)	Magasság.
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.

ImageTag

Objektum

Name	Típus	Description
created	string (date-time)
tagId	string (uuid)
tagName	string

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

Create Images From Data - Create Images From Data

URI-paraméterek

Kérelem fejléce

Válaszok

Biztonság

Training-Key

Példák

Successful CreateImagesFromData request

Mintakérelem

Mintaválasz

Definíciók

CustomVisionError

CustomVisionErrorCodes

Image

ImageCreateResult

ImageCreateStatus

ImageCreateSummary

ImageRegion

ImageTag