Projects - Create
Erstellen Sie ein Projekt.
POST {Endpoint}/customvision/v3.3/training/projects?name={name}POST {Endpoint}/customvision/v3.3/training/projects?name={name}&description={description}&domainId={domainId}&classificationType={classificationType}&targetExportPlatforms={targetExportPlatforms}URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string |
Unterstützte Cognitive Services-Endpunkte. |
|
name
|
query | True |
string |
Name des Projekts. |
|
classification
|
query |
string |
Der Typ des Klassifizierers, der für dieses Projekt erstellt werden soll. |
|
|
description
|
query |
string |
Die Beschreibung des Projekts. |
|
|
domain
|
query |
string (uuid) |
Die ID der Domäne, die für dieses Projekt verwendet werden soll. Standardwert ist "Allgemein". |
|
|
target
|
query |
string[] |
Liste der Plattformen, in die das trainierte Modell exportiert werden soll. |
Anforderungsheader
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| Training-Key | True |
string |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY Media Types: "application/json", "application/xml", "text/xml" |
|
| Other Status Codes |
Fehlerantwort Media Types: "application/json", "application/xml", "text/xml" |
Sicherheit
Training-Key
Typ:
apiKey
In:
header
Beispiele
Successful CreateProject request
Beispielanforderung
POST https://westus.api.cognitive.microsoft.com/customvision/v3.3/training/projects?name=My New Project&description=A test project&domainId=ee85a74c-405e-4adc-bb47-ffa8ca0c9f31
Beispiel für eine Antwort
{
"id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
"name": "My New Project",
"description": "A test project",
"settings": {
"domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
},
"created": "2017-12-18T05:43:18Z",
"lastModified": "2017-12-18T05:43:18Z",
"thumbnailUri": ""
}Definitionen
| Name | Beschreibung |
|---|---|
| Classifier |
Ruft den Klassifizierungstyp des Projekts ab. |
|
Custom |
|
|
Custom |
Der Fehlercode. |
|
Image |
Stellt die Einstellungen für die Vorverarbeitung von Bildern dar, die von der Bilderweiterung verwendet werden. |
| Project |
Steht für ein Projekt. |
|
Project |
Stellt Einstellungen dar, die einem Projekt zugeordnet sind. |
|
Project |
Ruft den Status des Projekts ab. |
|
Target |
Eine Liste der ExportPlatform, die vom trainierten Modell unterstützt werden soll. |
Classifier
Ruft den Klassifizierungstyp des Projekts ab.
| Wert | Beschreibung |
|---|---|
| Multiclass | |
| Multilabel |
CustomVisionError
| Name | Typ | Beschreibung |
|---|---|---|
| code |
Der Fehlercode. |
|
| message |
string |
Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt. |
CustomVisionErrorCodes
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 | |
| BadRequestImageExceededCount | |
| BadRequestTrainingNotNeeded | |
| BadRequestTrainingNotNeededButTrainingPipelineUpdated | |
| BadRequestTrainingValidationFailed | |
| BadRequestClassificationTrainingValidationFailed | |
| BadRequestMultiClassClassificationTrainingValidationFailed | |
| BadRequestMultiLabelClassificationTrainingValidationFailed | |
| BadRequestDetectionTrainingValidationFailed | |
| BadRequestTrainingAlreadyInProgress | |
| BadRequestDetectionTrainingNotAllowNegativeTag | |
| BadRequestInvalidEmailAddress | |
| BadRequestDomainNotSupportedForAdvancedTraining | |
| BadRequestExportPlatformNotSupportedForAdvancedTraining | |
| BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining | |
| BadRequestExportValidationFailed | |
| BadRequestExportAlreadyInProgress | |
| BadRequestPredictionIdsMissing | |
| BadRequestPredictionIdsExceededCount | |
| BadRequestPredictionTagsExceededCount | |
| BadRequestPredictionResultsExceededCount | |
| BadRequestPredictionInvalidApplicationName | |
| BadRequestPredictionInvalidQueryParameters | |
| BadRequestInvalidImportToken | |
| BadRequestExportWhileTraining | |
| BadRequestImageMetadataKey | |
| BadRequestImageMetadataValue | |
| BadRequestOperationNotSupported | |
| BadRequestInvalidArtifactUri | |
| BadRequestCustomerManagedKeyRevoked | |
| 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 | |
| ErrorInvalid |
ImageProcessingSettings
Stellt die Einstellungen für die Vorverarbeitung von Bildern dar, die von der Bilderweiterung verwendet werden.
| Name | Typ | Beschreibung |
|---|---|---|
| augmentationMethods |
object |
Ruft aktivierte Bildtransformationen ab oder legt diese fest. Der Schlüssel entspricht dem Transformationsnamen. Wenn der Wert auf "true" festgelegt ist, ist die Korrespondenttransformation aktiviert. Andernfalls wird diese Transformation nicht verwendet. Die Augmentation wird einheitlich unter aktivierten Transformationen verteilt. |
Project
Steht für ein Projekt.
| Name | Typ | Beschreibung |
|---|---|---|
| created |
string (date-time) |
Ruft das Datum ab, an dem dieses Projekt erstellt wurde. |
| description |
string |
Ruft die Beschreibung des Projekts ab oder legt diese fest. |
| drModeEnabled |
boolean |
Ruft ab, wenn der Notfallwiederherstellungsmodus aktiviert ist, der angibt, dass das Projekt vorübergehend schreibgeschützt ist. |
| id |
string (uuid) |
Ruft die Projekt-ID ab. |
| lastModified |
string (date-time) |
Ruft das Datum ab, an dem dieses Projekt zuletzt geändert wurde. |
| name |
string |
Ruft den Namen des Projekts ab oder legt den Namen fest. |
| settings |
Ruft die Projekteinstellungen ab oder legt sie fest. |
|
| status |
Ruft den Status des Projekts ab. |
|
| thumbnailUri |
string |
Ruft die Miniaturansichts-URL ab, die das Bild darstellt. 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. |
ProjectSettings
Stellt Einstellungen dar, die einem Projekt zugeordnet sind.
| Name | Typ | Beschreibung |
|---|---|---|
| classificationType |
Dient zum Abrufen oder Festlegen des Klassifizierungstyps des Projekts. |
|
| detectionParameters |
string |
Erkennungsparameter, falls vorhanden. |
| domainId |
string (uuid) |
Ruft die ID der Domäne ab, die mit diesem Projekt verwendet werden soll, oder legt sie fest. |
| imageProcessingSettings |
Dient zum Abrufen oder Festlegen von Einstellungen für die Vorverarbeitung von Bildern. |
|
| targetExportPlatforms |
Eine Liste der ExportPlatform, die vom trainierten Modell unterstützt werden soll. |
|
| useNegativeSet |
boolean |
Gibt an, ob negativer Satz verwendet wird. |
ProjectStatus
Ruft den Status des Projekts ab.
| Wert | Beschreibung |
|---|---|
| Succeeded | |
| Importing | |
| Failed |
TargetExportPlatforms
Eine Liste der ExportPlatform, die vom trainierten Modell unterstützt werden soll.
| Wert | Beschreibung |
|---|---|
| CoreML | |
| TensorFlow | |
| DockerFile | |
| ONNX | |
| VAIDK |