Create Images From Urls - Create Images From Urls

Dienst:: Azure AI Services

API-Version:: 3.4-preview

Fügen Sie die bereitgestellten Bild-URLs zur Gruppe von Schulungsbildern hinzu.
Diese API akzeptiert einen Batch von URLs und optional Tags zum Erstellen von Bildern. Es gibt eine Beschränkung von 64 Bildern und 20 Tags. Wenn alle Bilder erfolgreich erstellt wurden, wird der Statuscode 200(OK) zurückgegeben. Andernfalls wird der Statuscode 207 (Multi-Status) zurückgegeben, und der Detailstatus für jedes Bild wird in der Antwortnutzlast aufgeführt.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte.
projectId	path	True	string (uuid)	Die Projekt-ID.

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
Training-Key	True	string

Anforderungstext

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

Name	Typ	Beschreibung
images	ImageUrlCreateEntry[]
metadata	object	Die Metadaten des Bilds. Beschränkt auf 10 Schlüsselwertpaare pro Bild. Die Länge des Schlüssels ist auf 128 begrenzt. Die Länge des Werts ist auf 256 begrenzt.
tagIds	string[] (uuid)

Antworten

Name	Typ	Beschreibung
200 OK	ImageCreateSummary	OKAY 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	Fehlerantwort Media Types: "application/json", "application/xml", "text/xml"

Name

Typ

Beschreibung

200 OK

ImageCreateSummary

OKAY

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

Fehlerantwort

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

Sicherheit

Training-Key

Typ: apiKey
In: header

Beispiele

Successful CreateImagesFromUrls request

Beispielanforderung

HTTP

POST https://westus.api.cognitive.microsoft.com/customvision/v3.4-preview/training/projects/64b822c5-8082-4b36-a426-27225f4aa18c/images/urls


{
  "images": [
    {
      "url": "{url to image}"
    }
  ],
  "tagIds": [
    "b607964f-7bd6-4a3b-a869-6791fb6aab87"
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "isBatchSuccessful": true,
  "images": [
    {
      "sourceUrl": "{url to image}",
      "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 name"
          }
        ]
      }
    }
  ]
}

Statuscode:: 207

{
  "isBatchSuccessful": false,
  "images": [
    {
      "sourceUrl": "{url to image}",
      "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 name"
          }
        ]
      }
    },
    {
      "sourceUrl": "{url to image}",
      "status": "ErrorSource",
      "image": null
    }
  ]
}

Definitionen

Name	Beschreibung
CustomVisionError
CustomVisionErrorCodes	Der Fehlercode.
Image	Bildmodell, das als JSON gesendet werden soll.
ImageCreateResult
ImageCreateStatus	Status der Bilderstellung.
ImageCreateSummary
ImageRegion
ImageTag
ImageUrlCreateBatch
ImageUrlCreateEntry
Region

CustomVisionError

Objekt

Name	Typ	Beschreibung
code	CustomVisionErrorCodes	Der Fehlercode.
message	string	Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.

CustomVisionErrorCodes

Enumeration

Der Fehlercode.

Wert	Beschreibung
NoError
BadRequest
BadRequestExceededBatchSize
BadRequestNotSupported
BadRequestInvalidIds
BadRequestProjectName
BadRequestProjectNameNotUnique
BadRequestProjectDescription
BadRequestProjectUnknownDomain
BadRequestProjectUnknownClassification
BadRequestProjectUnsupportedDomainTypeChange
BadRequestProjectUnsupportedExportPlatform
BadRequestProjectImagePreprocessingSettings
BadRequestProjectDuplicated
BadRequestIterationName
BadRequestIterationNameNotUnique
BadRequestIterationDescription
BadRequestIterationIsNotTrained
BadRequestIterationValidationFailed
BadRequestWorkspaceCannotBeModified
BadRequestWorkspaceNotDeletable
BadRequestTagName
BadRequestTagNameNotUnique
BadRequestTagDescription
BadRequestTagType
BadRequestMultipleNegativeTag
BadRequestMultipleGeneralProductTag
BadRequestImageTags
BadRequestImageRegions
BadRequestNegativeAndRegularTagOnSameImage
BadRequestUnsupportedDomain
BadRequestRequiredParamIsNull
BadRequestIterationIsPublished
BadRequestInvalidPublishName
BadRequestInvalidPublishTarget
BadRequestUnpublishFailed
BadRequestIterationNotPublished
BadRequestSubscriptionApi
BadRequestExceedProjectLimit
BadRequestExceedIterationPerProjectLimit
BadRequestExceedTagPerProjectLimit
BadRequestExceedTagPerImageLimit
BadRequestExceededQuota
BadRequestCannotMigrateProjectWithName
BadRequestNotLimitedTrial
BadRequestImageBatch
BadRequestImageStream
BadRequestImageUrl
BadRequestImageFormat
BadRequestImageSizeBytes
BadRequestImageDimensions
BadRequestImageAspectRatio
BadRequestImageExceededCount
BadRequestTrainingNotNeeded
BadRequestTrainingNotNeededButTrainingPipelineUpdated
BadRequestTrainingValidationFailed
BadRequestClassificationTrainingValidationFailed
BadRequestMultiClassClassificationTrainingValidationFailed
BadRequestMultiLabelClassificationTrainingValidationFailed
BadRequestDetectionTrainingValidationFailed
BadRequestTrainingAlreadyInProgress
BadRequestDetectionTrainingNotAllowNegativeTag
BadRequestInvalidEmailAddress
BadRequestRetiredDomainNotSupportedForTraining
BadRequestDomainNotSupportedForAdvancedTraining
BadRequestExportPlatformNotSupportedForAdvancedTraining
BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining
BadRequestCustomBaseModelIterationStatusNotCompleted
BadRequestCustomBaseModelDomainNotCompatible
BadRequestCustomBaseModelArchitectureRetired
BadRequestExportValidationFailed
BadRequestExportAlreadyInProgress
BadRequestPredictionIdsMissing
BadRequestPredictionIdsExceededCount
BadRequestPredictionTagsExceededCount
BadRequestPredictionResultsExceededCount
BadRequestPredictionInvalidApplicationName
BadRequestPredictionInvalidQueryParameters
BadRequestInvalidImportToken
BadRequestExportWhileTraining
BadRequestImageMetadataKey
BadRequestImageMetadataValue
BadRequestOperationNotSupported
BadRequestInvalidArtifactUri
BadRequestCustomerManagedKeyRevoked
BadRequestInvalidUri
BadRequestInvalid
UnsupportedMediaType
Forbidden
ForbiddenUser
ForbiddenUserResource
ForbiddenUserSignupDisabled
ForbiddenUserSignupAllowanceExceeded
ForbiddenUserDoesNotExist
ForbiddenUserDisabled
ForbiddenUserInsufficientCapability
ForbiddenDRModeEnabled
ForbiddenInvalid
NotFound
NotFoundProject
NotFoundProjectDefaultIteration
NotFoundIteration
NotFoundIterationPerformance
NotFoundTag
NotFoundImage
NotFoundDomain
NotFoundApimSubscription
NotFoundInvalid
Conflict
ConflictInvalid
ErrorUnknown
ErrorIterationCopyFailed
ErrorPreparePerformanceMigrationFailed
ErrorProjectInvalidWorkspace
ErrorProjectInvalidPipelineConfiguration
ErrorProjectInvalidDomain
ErrorProjectTrainingRequestFailed
ErrorProjectImportRequestFailed
ErrorProjectExportRequestFailed
ErrorFeaturizationServiceUnavailable
ErrorFeaturizationQueueTimeout
ErrorFeaturizationInvalidFeaturizer
ErrorFeaturizationAugmentationUnavailable
ErrorFeaturizationUnrecognizedJob
ErrorFeaturizationAugmentationError
ErrorExporterInvalidPlatform
ErrorExporterInvalidFeaturizer
ErrorExporterInvalidClassifier
ErrorPredictionServiceUnavailable
ErrorPredictionModelNotFound
ErrorPredictionModelNotCached
ErrorPrediction
ErrorPredictionStorage
ErrorRegionProposal
ErrorUnknownBaseModel
ErrorServerTimeOut
ErrorInvalid

Image

Objekt

Bildmodell, das als JSON gesendet werden soll.

Name	Typ	Beschreibung
created	string (date-time)	Das Erstellungsdatum des Bilds.
height	integer (int32)	Höhe des Bilds.
id	string (uuid)	ID des Bilds.
metadata	object	Diesem Bild zugeordnete Metadaten.
originalImageUri	string	Der URI für das ursprüngliche hochgeladene Bild. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.
regions	ImageRegion[]	Diesem Bild zugeordnete Regionen.
resizedImageUri	string	Der URI zum (verkleinerten) Bild, das für die Schulung verwendet wird. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.
tags	ImageTag[]	Tags, die diesem Bild zugeordnet sind.
thumbnailUri	string	Der URI für die Miniaturansicht des Originalbilds. Wenn das VNET-Feature aktiviert ist, handelt es sich um einen relativen Pfad, der mit GetArtifact verwendet werden soll, andernfalls handelt es sich um einen absoluten URI für die Ressource.
width	integer (int32)	Breite des Bilds.

ImageCreateResult

Objekt

Name	Typ	Beschreibung
image	Image	Das Bild.
sourceUrl	string	Quell-URL des Bilds.
status	ImageCreateStatus	Status der Bilderstellung.

ImageCreateStatus

Enumeration

Status der Bilderstellung.

Wert	Beschreibung
OK
OKDuplicate
ErrorSource
ErrorImageFormat
ErrorImageSize
ErrorStorage
ErrorLimitExceed
ErrorTagLimitExceed
ErrorRegionLimitExceed
ErrorUnknown
ErrorNegativeAndRegularTagOnSameImage
ErrorImageDimensions
ErrorInvalidTag

ImageCreateSummary

Objekt

Name	Typ	Beschreibung
images	ImageCreateResult[]	Liste der Ergebnisse der Bilderstellung.
isBatchSuccessful	boolean	True, wenn alle Bilder im Batch erfolgreich erstellt wurden, andernfalls "false".

ImageRegion

Objekt

Name	Typ	Beschreibung
created	string (date-time)
height	number (float)	Höhe.
left	number (float)	Koordinate der linken Grenze.
regionId	string (uuid)
tagId	string (uuid)	ID des Tags, das diesem Bereich zugeordnet ist.
tagName	string
top	number (float)	Koordinate der oberen Grenze.
width	number (float)	Breite.

ImageTag

Objekt

Name	Typ	Beschreibung
created	string (date-time)
tagId	string (uuid)
tagName	string

ImageUrlCreateBatch

Objekt

Name	Typ	Beschreibung
images	ImageUrlCreateEntry[]
metadata	object	Die Metadaten des Bilds. Beschränkt auf 10 Schlüsselwertpaare pro Bild. Die Länge des Schlüssels ist auf 128 begrenzt. Die Länge des Werts ist auf 256 begrenzt.
tagIds	string[] (uuid)

ImageUrlCreateEntry

Objekt

Name	Typ	Beschreibung
regions	Region[]
tagIds	string[] (uuid)
url	string	URL des Bilds.

Region

Objekt

Name	Typ	Beschreibung
height	number (float)	Höhe.
left	number (float)	Koordinate der linken Grenze.
tagId	string (uuid)	ID des Tags, das diesem Bereich zugeordnet ist.
top	number (float)	Koordinate der oberen Grenze.
width	number (float)	Breite.