Images - Create From Data
이 API는 본문 콘텐츠를 multipart/form-data 및 application/octet-stream으로 허용합니다. 다중 파트를 사용하는 경우 최대 64개의 파일을 사용하여 여러 이미지 파일을 한 번에 보낼 수 있습니다. 모든 이미지를 성공적으로 만들면 200(OK) 상태 코드가 반환됩니다. 그렇지 않으면 207(다중 상태) 상태 코드가 반환되고 각 이미지의 세부 상태가 응답 페이로드에 나열됩니다.
POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/images
POST {Endpoint}/customvision/v3.3/training/projects/{projectId}/images?tagIds={tagIds}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
image
|
formData | True |
file |
이진 이미지 데이터입니다. 지원되는 형식은 JPEG, GIF, PNG 및 BMP입니다. 최대 6MB의 이미지를 지원합니다. |
Endpoint
|
path | True |
string |
지원되는 Cognitive Services 엔드포인트. |
project
|
path | True |
string (uuid) |
프로젝트 ID입니다. |
tag
|
query |
string[] |
각 이미지에 태그를 지정하는 태그 ID입니다. 20으로 제한됩니다. |
요청 헤더
Media Types: "multipart/form-data", "application/octet-stream"
Name | 필수 | 형식 | Description |
---|---|---|---|
Training-Key | True |
string |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 Media Types: "application/json", "application/xml", "text/xml" |
|
Other Status Codes |
207 Media Types: "application/json", "application/xml", "text/xml" |
|
Other Status Codes |
오류 응답 Media Types: "application/json", "application/xml", "text/xml" |
보안
Training-Key
형식:
apiKey
In(다음 안에):
header
예제
Successful CreateImagesFromData request
샘플 요청
POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/images?tagIds=b607964f-7bd6-4a3b-a869-6791fb6aab87
샘플 응답
{
"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"
}
]
}
}
]
}
{
"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"
}
]
}
정의
Name | Description |
---|---|
Custom |
|
Custom |
오류 코드입니다. |
Image |
JSON으로 보낼 이미지 모델입니다. |
Image |
|
Image |
이미지 만들기의 상태입니다. |
Image |
|
Image |
|
Image |
CustomVisionError
Name | 형식 | Description |
---|---|---|
code |
오류 코드입니다. |
|
message |
string |
서비스에서 보고한 오류를 설명하는 메시지입니다. |
CustomVisionErrorCodes
오류 코드입니다.
값 | 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 |
Image
JSON으로 보낼 이미지 모델입니다.
Name | 형식 | Description |
---|---|---|
created |
string (date-time) |
이미지를 만든 날짜입니다. |
height |
integer (int32) |
이미지의 높이입니다. |
id |
string (uuid) |
이미지의 ID입니다. |
metadata |
object |
이 이미지와 연결된 메타데이터입니다. |
originalImageUri |
string |
원래 업로드된 이미지의 URI입니다. VNET 기능을 사용하도록 설정하면 GetArtifact와 함께 사용할 상대 경로가 되며, 그렇지 않으면 리소스에 대한 절대 URI가 됩니다. |
regions |
이 이미지와 연결된 지역입니다. |
|
resizedImageUri |
string |
학습에 사용되는 크기가 조정된 이미지의 URI입니다. VNET 기능을 사용하도록 설정하면 GetArtifact와 함께 사용할 상대 경로가 되며, 그렇지 않으면 리소스에 대한 절대 URI가 됩니다. |
tags |
Image |
이 이미지와 연결된 태그입니다. |
thumbnailUri |
string |
원본 이미지의 축소판 그림에 대한 URI입니다. VNET 기능을 사용하도록 설정하면 GetArtifact와 함께 사용할 상대 경로가 되며, 그렇지 않으면 리소스에 대한 절대 URI가 됩니다. |
width |
integer (int32) |
이미지의 너비입니다. |
ImageCreateResult
Name | 형식 | Description |
---|---|---|
image |
이미지입니다. |
|
sourceUrl |
string |
이미지의 원본 URL입니다. |
status |
이미지 만들기의 상태입니다. |
ImageCreateStatus
이미지 만들기의 상태입니다.
값 | Description |
---|---|
ErrorImageFormat | |
ErrorImageSize | |
ErrorLimitExceed | |
ErrorNegativeAndRegularTagOnSameImage | |
ErrorRegionLimitExceed | |
ErrorSource | |
ErrorStorage | |
ErrorTagLimitExceed | |
ErrorUnknown | |
OK | |
OKDuplicate |
ImageCreateSummary
Name | 형식 | Description |
---|---|---|
images |
이미지 만들기 결과 목록입니다. |
|
isBatchSuccessful |
boolean |
일괄 처리의 모든 이미지가 성공적으로 만들어진 경우 True이면 true이고, 그렇지 않으면 false입니다. |
ImageRegion
Name | 형식 | Description |
---|---|---|
created |
string (date-time) |
|
height |
number (float) |
높이. |
left |
number (float) |
왼쪽 경계의 좌표입니다. |
regionId |
string (uuid) |
|
tagId |
string (uuid) |
이 지역과 연결된 태그의 ID입니다. |
tagName |
string |
|
top |
number (float) |
위쪽 경계의 좌표입니다. |
width |
number (float) |
너비. |
ImageTag
Name | 형식 | Description |
---|---|---|
created |
string (date-time) |
|
tagId |
string (uuid) |
|
tagName |
string |