Partager via


Projects - Create

Crée un projet.

POST {endpoint}/speechtotext/v3.2-preview.2/projects

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).

Corps de la demande

Nom Obligatoire Type Description
displayName True

string

minLength: 1

Nom complet de l’objet.

locale True

string

minLength: 1

Paramètres régionaux des données contenues.

customProperties

object

Propriétés personnalisées de cette entité. La longueur maximale autorisée de la clé est de 64 caractères, la longueur maximale de la valeur autorisée est de 256 caractères et le nombre d’entrées autorisées est de 10.

description

string

Description de l'objet .

Réponses

Nom Type Description
201 Created

Project

La réponse contient des informations sur l’entité en tant que charge utile et son emplacement en tant qu’en-tête.

En-têtes

Location: string

Other Status Codes

Error

Une erreur est survenue.

Sécurité

Ocp-Apim-Subscription-Key

Fournissez la clé de votre compte Cognitive Services ici.

Type: apiKey
Dans: header

Authorization

Fournissez un jeton d’accès à partir du JWT retourné par le STS de cette région. Veillez à ajouter l’étendue de gestion au jeton en ajoutant la chaîne de requête suivante à l’URL STS : ?scope=speechservicesmanagement

Type: apiKey
Dans: header

Exemples

Create a project

Exemple de requête

POST {endpoint}/speechtotext/v3.2-preview.2/projects

{
  "locale": "en-US",
  "displayName": "My speech project"
}

Exemple de réponse

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
  "links": {
    "evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
    "datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
    "models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
    "endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
    "transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
  },
  "properties": {
    "datasetCount": 23,
    "evaluationCount": 42,
    "modelCount": 2,
    "transcriptionCount": 1994,
    "endpointCount": 12
  },
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "My speech project"
}

Définitions

Nom Description
DetailedErrorCode

DetailedErrorCode

Error

Erreur

ErrorCode

ErrorCode

InnerError

InnerError

Project

Project

ProjectLinks

ProjectLinks

ProjectProperties

ProjectProperties

DetailedErrorCode

DetailedErrorCode

Valeur Description
DataImportFailed

Échec de l’importation des données.

DeleteNotAllowed

Supprimer non autorisé.

DeployNotAllowed

Déploiement non autorisé.

DeployingFailedModel

Déploiement d’un modèle ayant échoué.

EmptyRequest

Requête vide.

EndpointCannotBeDefault

Le point de terminaison ne peut pas être par défaut.

EndpointNotUpdatable

Point de terminaison non modifiable.

EndpointWithoutLogging

Point de terminaison sans journalisation.

ExceededNumberOfRecordingsUris

Dépassement du nombre d’URI d’enregistrements.

FailedDataset

Échec du jeu de données.

Forbidden

Interdit.

InUseViolation

Violation en cours d’utilisation.

InaccessibleCustomerStorage

Stockage client inaccessible.

InvalidAdaptationMapping

Mappage d’adaptation non valide.

InvalidBaseModel

Modèle de base non valide.

InvalidCallbackUri

URI de rappel non valide.

InvalidCollection

Collection non valide.

InvalidDataset

Jeu de données non valide.

InvalidDocument

Document non valide.

InvalidDocumentBatch

Lot de documents non valide.

InvalidLocale

Paramètres régionaux non valides.

InvalidLogDate

Date de journal non valide.

InvalidLogEndTime

Heure de fin du journal non valide.

InvalidLogId

ID de journal non valide.

InvalidLogStartTime

Heure de début du journal non valide.

InvalidModel

Modèle non valide.

InvalidModelUri

URI de modèle non valide.

InvalidParameter

Paramètre non valide.

InvalidParameterValue

Valeur de paramètre non valide.

InvalidPayload

Charge utile non valide.

InvalidPermissions

Autorisations non valides.

InvalidPrerequisite

Prérequis non valides.

InvalidProductId

ID de produit non valide.

InvalidProject

Projet non valide.

InvalidProjectKind

Type de projet non valide.

InvalidRecordingsUri

Uri des enregistrements non valides.

InvalidRequestBodyFormat

Format du corps de la demande non valide.

InvalidSasValidityDuration

Durée de validité de sas non valide.

InvalidSkipTokenForLogs

Jeton d’ignorer non valide pour les journaux.

InvalidSourceAzureResourceId

ID de ressource Azure source non valide.

InvalidSubscription

Abonnement non valide.

InvalidTest

Test non valide.

InvalidTimeToLive

Durée de vie non valide.

InvalidTopForLogs

Top non valide pour les journaux.

InvalidTranscription

Transcription non valide.

InvalidWebHookEventKind

Type d’événement web hook non valide.

MissingInputRecords

Enregistrements d’entrée manquants.

ModelCopyOperationExists

L’opération de copie de modèle existe.

ModelDeploymentNotCompleteState

État non terminé du déploiement du modèle.

ModelDeprecated

Modèle déconseillé.

ModelExists

Le modèle existe.

ModelMismatch

Incompatibilité de modèle.

ModelNotDeployable

Modèle non déployable.

ModelVersionIncorrect

Version du modèle incorrecte.

NoUtf8WithBom

Pas de utf8 avec bom.

OnlyOneOfUrlsOrContainerOrDataset

Une seule url ou conteneur ou jeu de données.

ProjectGenderMismatch

Projet d’incompatibilité entre les sexes.

QuotaViolation

Violation de quota.

SingleDefaultEndpoint

Point de terminaison par défaut unique.

SkuLimitsExist

Des limites de référence SKU existent.

SubscriptionNotFound

Abonnement introuvable.

UnexpectedError

Erreur inattendue.

UnsupportedClassBasedAdaptation

Adaptation basée sur les classes non prise en charge.

UnsupportedDelta

Delta non pris en charge.

UnsupportedDynamicConfiguration

Configuration dynamique non prise en charge.

UnsupportedFilter

Filtre non pris en charge.

UnsupportedLanguageCode

Code de langue non pris en charge.

UnsupportedOrderBy

Commande non prise en charge par.

UnsupportedPagination

Pagination non prise en charge.

UnsupportedTimeRange

Intervalle de temps non pris en charge.

Error

Erreur

Nom Type Description
code

ErrorCode

ErrorCode
Codes d’erreur de haut niveau.

details

Error[]

Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.

innerError

InnerError

InnerError
Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).

message

string

Message d’erreur de haut niveau.

target

string

Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

ErrorCode

ErrorCode

Valeur Description
Conflict

Représentant le code d’erreur de conflit.

Forbidden

Représentant le code d’erreur interdit.

InternalCommunicationFailed

Représentant le code d’erreur d’échec de la communication interne.

InternalServerError

Représentant le code d’erreur interne du serveur.

InvalidArgument

Représentant le code d’erreur de l’argument non valide.

InvalidRequest

Représentant le code d’erreur de requête non valide.

NotAllowed

Représentant le code d’erreur non autorisé.

NotFound

Représentant le code d’erreur introuvable.

PipelineError

Représentant le code d’erreur du pipeline.

ServiceUnavailable

Représentant le code d’erreur indisponible du service.

TooManyRequests

Représentant le code d’erreur de trop de requêtes.

Unauthorized

Représentant le code d’erreur non autorisé.

UnprocessableEntity

Représentant le code d’erreur d’entité non traité.

UnsupportedMediaType

Représentant le code d’erreur de type multimédia non pris en charge.

InnerError

InnerError

Nom Type Description
code

DetailedErrorCode

DetailedErrorCode
Énumération détaillée du code d’erreur.

details

object

Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.

innerError

InnerError

InnerError
Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).

message

string

Message d’erreur de haut niveau.

target

string

Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

Project

Project

Nom Type Description
createdDateTime

string (date-time)

Horodatage de la création de l’objet. L’horodatage est encodé au format de date et d’heure ISO 8601 (« AAAA-MM-JJThh :mm :ssZ », voir https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

customProperties

object

Propriétés personnalisées de cette entité. La longueur maximale autorisée de la clé est de 64 caractères, la longueur maximale de la valeur autorisée est de 256 caractères et le nombre d’entrées autorisées est de 10.

description

string

Description de l'objet .

displayName

string

minLength: 1

Nom complet de l’objet.

links

ProjectLinks

ProjectLinks

locale

string

minLength: 1

Paramètres régionaux des données contenues.

properties

ProjectProperties

ProjectProperties

self

string (uri)

Emplacement de cette entité.

ProjectLinks

Nom Type Description
datasets

string (uri)

Emplacement permettant d’obtenir la liste de tous les jeux de données de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListDatasets ».

endpoints

string (uri)

Emplacement permettant d’obtenir la liste de tous les points de terminaison de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListEndpoints ».

evaluations

string (uri)

Emplacement où obtenir la liste de toutes les évaluations de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListEvaluations ».

models

string (uri)

Emplacement pour obtenir la liste de tous les modèles de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListModels ».

transcriptions

string (uri)

Emplacement pour obtenir la liste de toutes les transcriptions de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListTranscriptions ».

ProjectProperties

ProjectProperties

Nom Type Description
datasetCount

integer (int32)

Nombre de jeux de données associés à ce projet.

endpointCount

integer (int32)

Nombre de points de terminaison associés à ce projet.

evaluationCount

integer (int32)

Nombre d’évaluations associées à ce projet.

modelCount

integer (int32)

Nombre de modèles associés à ce projet.

transcriptionCount

integer (int32)

Nombre de transcriptions associées à ce projet.