Compartir a través de


Projects - Create

Cree un proyecto.

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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
Endpoint
path True

string

Puntos de conexión de Cognitive Services admitidos.

name
query True

string

Nombre del proyecto.

classificationType
query

string

Tipo de clasificador que se va a crear para este proyecto.

description
query

string

Descripción del proyecto.

domainId
query

string (uuid)

Identificador del dominio que se va a usar para este proyecto. El valor predeterminado es General.

targetExportPlatforms
query

string[]

Lista de plataformas a las que el modelo entrenado pretende exportar.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Training-Key True

string

Respuestas

Nombre Tipo Description
200 OK

Project

De acuerdo

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

Other Status Codes

CustomVisionError

Respuesta de error

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

Seguridad

Training-Key

Tipo: apiKey
En: header

Ejemplos

Successful CreateProject request

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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": ""
}

Definiciones

Nombre Description
Classifier

Obtiene el tipo de clasificación del proyecto.

CustomVisionError
CustomVisionErrorCodes

Código de error.

ImageProcessingSettings

Representa la configuración de preprocesamiento de imágenes usada por el aumento de imágenes.

Project

Representa un proyecto.

ProjectSettings

Representa la configuración asociada a un proyecto.

ProjectStatus

Obtiene el estado del proyecto.

TargetExportPlatforms

Lista de ExportPlatform que el modelo entrenado debe ser compatible.

Classifier

Obtiene el tipo de clasificación del proyecto.

Valor Description
Multiclass
Multilabel

CustomVisionError

Nombre Tipo Description
code

CustomVisionErrorCodes

Código de error.

message

string

Mensaje que explica el error notificado por el servicio.

CustomVisionErrorCodes

Código de error.

Valor 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

Representa la configuración de preprocesamiento de imágenes usada por el aumento de imágenes.

Nombre Tipo Description
augmentationMethods

object

Obtiene o establece transformaciones de imagen habilitadas. La clave corresponde al nombre de la transformación. Si el valor se establece en true, se habilita la transformación correspondiente. De lo contrario, esta transformación no se usará. El aumento se distribuirá uniformemente entre transformaciones habilitadas.

Project

Representa un proyecto.

Nombre Tipo Description
created

string (date-time)

Obtiene la fecha en que se creó este proyecto.

description

string

Obtiene o establece la descripción del proyecto.

drModeEnabled

boolean

Obtiene si el modo de recuperación ante desastres (DR) está activado, lo que indica que el proyecto es de solo lectura temporalmente.

id

string (uuid)

Obtiene el identificador del proyecto.

lastModified

string (date-time)

Obtiene la fecha en que se modificó por última vez este proyecto.

name

string

Obtiene o establece el nombre del proyecto.

settings

ProjectSettings

Obtiene o establece la configuración del proyecto.

status

ProjectStatus

Obtiene el estado del proyecto.

thumbnailUri

string

Obtiene la dirección URL de miniatura que representa la imagen. Si la característica de red virtual está habilitada, será una ruta de acceso relativa que se usará con GetArtifact; de lo contrario, será un URI absoluto para el recurso.

ProjectSettings

Representa la configuración asociada a un proyecto.

Nombre Tipo Description
classificationType

Classifier

Obtiene o establece el tipo de clasificación del proyecto.

detectionParameters

string

Parámetros de detección en uso, si los hay.

domainId

string (uuid)

Obtiene o establece el identificador del dominio que se va a usar con este proyecto.

imageProcessingSettings

ImageProcessingSettings

Obtiene o establece la configuración de preprocesamiento de imágenes.

targetExportPlatforms

TargetExportPlatforms[]

Lista de ExportPlatform que el modelo entrenado debe ser compatible.

useNegativeSet

boolean

Indica si se usa un conjunto negativo.

ProjectStatus

Obtiene el estado del proyecto.

Valor Description
Succeeded
Importing
Failed

TargetExportPlatforms

Lista de ExportPlatform que el modelo entrenado debe ser compatible.

Valor Description
CoreML
TensorFlow
DockerFile
ONNX
VAIDK