Udostępnij przez

Projects - Create

Usługa:
Azure AI Services
Wersja interfejsu API:
3.3

Utwórz projekt.

POST {Endpoint}/customvision/v3.3/training/projects?name={name}
Z parametrami opcjonalnymi: 
POST {Endpoint}/customvision/v3.3/training/projects?name={name}&description={description}&domainId={domainId}&classificationType={classificationType}&targetExportPlatforms={targetExportPlatforms}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
Endpoint
 path True

string

Obsługiwane punkty końcowe usług Cognitive Services.
name
 query True

string

Nazwa projektu.
classificationType
 query

string

Typ klasyfikatora do utworzenia dla tego projektu.
description
 query

string

Opis projektu.
domainId
 query

string (uuid)

Identyfikator domeny do użycia dla tego projektu. Wartość domyślna to Ogólne.
targetExportPlatforms
 query

string[]

Lista platform, do których zamierza eksportować wytrenowany model.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Training-Key True

string

Odpowiedzi

Nazwa Typ Opis
200 OK

Project

OK

Media Types: "application/json", "application/xml", "text/xml"
Other Status Codes

CustomVisionError

Odpowiedź na błąd

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

Zabezpieczenia

Training-Key

Typ: apiKey
W: header

Przykłady

Successful CreateProject request

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
Classifier

Pobiera typ klasyfikacji projektu.
CustomVisionError
CustomVisionErrorCodes

Kod błędu.
ImageProcessingSettings

Reprezentuje ustawienia przetwarzania wstępnego obrazu używane przez rozszerzenie obrazu.
Project

Reprezentuje projekt.
ProjectSettings

Reprezentuje ustawienia skojarzone z projektem.
ProjectStatus

Pobiera stan projektu.
TargetExportPlatforms

Lista exportPlatform, którą wytrenowany model powinien być w stanie obsłużyć.

Classifier

Wyliczanie

Pobiera typ klasyfikacji projektu.

Wartość Opis
Multiclass
Multilabel

CustomVisionError

Objekt
Nazwa Typ Opis
code

CustomVisionErrorCodes

Kod błędu.
message

string

Komunikat wyjaśniający błąd zgłoszony przez usługę.

CustomVisionErrorCodes

Wyliczanie

Kod błędu.

Wartość Opis
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

Objekt

Reprezentuje ustawienia przetwarzania wstępnego obrazu używane przez rozszerzenie obrazu.

Nazwa Typ Opis
augmentationMethods

object

Pobiera lub ustawia włączone przekształcenia obrazów. Klucz odpowiada nazwie przekształcenia. Jeśli wartość jest ustawiona na true, transformacja korespondenta jest włączona. W przeciwnym razie ta transformacja nie zostanie użyta. Rozszerzenie będzie równomiernie rozłożone między włączone przekształcenia.

Project

Objekt

Reprezentuje projekt.

Nazwa Typ Opis
created

string (date-time)

Pobiera datę utworzenia tego projektu.
description

string

Pobiera lub ustawia opis projektu.
drModeEnabled

boolean

Pobiera, jeśli tryb odzyskiwania po awarii (DR) jest włączony, wskazując, że projekt jest tymczasowo tylko do odczytu.
id

string (uuid)

Pobiera identyfikator projektu.
lastModified

string (date-time)

Pobiera datę ostatniej modyfikacji tego projektu.
name

string

Pobiera lub ustawia nazwę projektu.
settings

ProjectSettings

Pobiera lub ustawia ustawienia projektu.
status

ProjectStatus

Pobiera stan projektu.
thumbnailUri

string

Pobiera adres URL miniatur reprezentujący obraz. Jeśli funkcja sieci wirtualnej jest włączona, będzie to ścieżka względna do użycia z getArtifact, w przeciwnym razie będzie to bezwzględny identyfikator URI zasobu.

ProjectSettings

Objekt

Reprezentuje ustawienia skojarzone z projektem.

Nazwa Typ Opis
classificationType

Classifier

Pobiera lub ustawia typ klasyfikacji projektu.
detectionParameters

string

Parametry wykrywania w użyciu, jeśli istnieją.
domainId

string (uuid)

Pobiera lub ustawia identyfikator domeny do użycia z tym projektem.
imageProcessingSettings

ImageProcessingSettings

Pobiera lub ustawia ustawienia przetwarzania wstępnego obrazu.
targetExportPlatforms

TargetExportPlatforms[]

Lista exportPlatform, którą wytrenowany model powinien być w stanie obsłużyć.
useNegativeSet

boolean

Wskazuje, czy jest używany zestaw ujemny.

ProjectStatus

Wyliczanie

Pobiera stan projektu.

Wartość Opis
Succeeded
Importing
Failed

TargetExportPlatforms

Wyliczanie

Lista exportPlatform, którą wytrenowany model powinien być w stanie obsłużyć.

Wartość Opis
CoreML
TensorFlow
DockerFile
ONNX
VAIDK