Projects - Create
Créez un projet.
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}
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Endpoint
|
path | True |
string |
Points de terminaison Cognitive Services pris en charge. |
|
name
|
query | True |
string |
Nom du projet. |
|
classification
|
query |
string |
Type de classifieur à créer pour ce projet. |
|
|
description
|
query |
string |
Description du projet. |
|
|
domain
|
query |
string (uuid) |
ID du domaine à utiliser pour ce projet. La valeur par défaut est Général. |
|
|
target
|
query |
string[] |
La liste des plateformes vers lesquelles le modèle entraîné est en cours d’exportation. |
En-tête de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| Training-Key | True |
string |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
D’ACCORD Media Types: "application/json", "application/xml", "text/xml" |
|
| Other Status Codes |
Réponse d’erreur Media Types: "application/json", "application/xml", "text/xml" |
Sécurité
Training-Key
Type:
apiKey
Dans:
header
Exemples
Successful CreateProject request
Exemple de requête
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
Exemple de réponse
{
"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": ""
}
Définitions
| Nom | Description |
|---|---|
| Classifier |
Obtient le type de classification du projet. |
|
Custom |
|
|
Custom |
Code d’erreur. |
|
Image |
Représente les paramètres de prétraitement d’image utilisés par l’augmentation de l’image. |
| Project |
Représente un projet. |
|
Project |
Représente les paramètres associés à un projet. |
|
Project |
Obtient l’état du projet. |
|
Target |
Liste d’ExportPlatform que le modèle entraîné doit être en mesure de prendre en charge. |
Classifier
Obtient le type de classification du projet.
| Valeur | Description |
|---|---|
| Multiclass | |
| Multilabel |
CustomVisionError
| Nom | Type | Description |
|---|---|---|
| code |
Code d’erreur. |
|
| message |
string |
Message expliquant l’erreur signalée par le service. |
CustomVisionErrorCodes
Code d’erreur.
| Valeur | Description |
|---|---|
| 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
Représente les paramètres de prétraitement d’image utilisés par l’augmentation de l’image.
| Nom | Type | Description |
|---|---|---|
| augmentationMethods |
object |
Obtient ou définit les transformations d’image activées. La clé correspond au nom de la transformation. Si la valeur est définie sur true, la transformation correspondante est activée. Sinon, cette transformation ne sera pas utilisée. L’augmentation sera répartie uniformément entre les transformations activées. |
Project
Représente un projet.
| Nom | Type | Description |
|---|---|---|
| created |
string (date-time) |
Obtient la date de création de ce projet. |
| description |
string |
Obtient ou définit la description du projet. |
| drModeEnabled |
boolean |
Obtient si le mode récupération d’urgence est activé, indiquant que le projet est temporairement en lecture seule. |
| id |
string (uuid) |
Obtient l’ID de projet. |
| lastModified |
string (date-time) |
Obtient la date de dernière modification de ce projet. |
| name |
string |
Obtient ou définit le nom du projet. |
| settings |
Obtient ou définit les paramètres du projet. |
|
| status |
Obtient l’état du projet. |
|
| thumbnailUri |
string |
Obtient l’URL miniature représentant l’image. Si la fonctionnalité de réseau virtuel est activée, il s’agit d’un chemin relatif à utiliser avec GetArtifact. Sinon, il s’agit d’un URI absolu vers la ressource. |
ProjectSettings
Représente les paramètres associés à un projet.
| Nom | Type | Description |
|---|---|---|
| classificationType |
Obtient ou définit le type de classification du projet. |
|
| detectionParameters |
string |
Paramètres de détection en cours d’utilisation, le cas échéant. |
| domainId |
string (uuid) |
Obtient ou définit l’ID du domaine à utiliser avec ce projet. |
| imageProcessingSettings |
Obtient ou définit les paramètres de prétraitement d’image. |
|
| targetExportPlatforms |
Liste d’ExportPlatform que le modèle entraîné doit être en mesure de prendre en charge. |
|
| useNegativeSet |
boolean |
Indique si un jeu négatif est utilisé. |
ProjectStatus
Obtient l’état du projet.
| Valeur | Description |
|---|---|
| Succeeded | |
| Importing | |
| Failed |
TargetExportPlatforms
Liste d’ExportPlatform que le modèle entraîné doit être en mesure de prendre en charge.
| Valeur | Description |
|---|---|
| CoreML | |
| TensorFlow | |
| DockerFile | |
| ONNX | |
| VAIDK |