Training Sets - Create

Service:

Cognitive Services - Custom Voice

API Version:

2023-12-01-preview

Crée un jeu d’entraînement.

PUT {endpoint}/customvoice/trainingsets/{id}?api-version=2023-12-01-preview

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://eastus.api.cognitive.microsoft.com).
id	path	True	string	ID de la ressource. Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string	Fournissez votre clé de ressource Speech ici.

Corps de la demande

Nom	Obligatoire	Type	Description
locale	True	string	Paramètres régionaux du jeu de données d’entraînement. Le code de paramètres régionaux suit BCP-47. Vous trouverez la liste des paramètres régionaux de synthèse vocale ici https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	True	string	ID de la ressource
description		string	Description du jeu d’entraînement
displayName		string	Nom du jeu d’entraînement
id		string	ID de la ressource
status		Status	État d’une ressource.
voiceKind		VoiceKind	Type de voix

Réponses

Nom	Type	Description
201 Created	TrainingSet	Date de création
Other Status Codes	ErrorResponse	Une erreur est survenue.

Sécurité

Ocp-Apim-Subscription-Key

Fournissez votre clé de ressource Speech ici.

Type: apiKey
In: header

Exemples

Create a training set

Sample Request

HTTP

PUT {endpoint}/customvoice/trainingsets/Jessica-300?api-version=2023-12-01-preview


{
  "description": "300 sentences Jessica data in general style.",
  "projectId": "Jessica",
  "locale": "en-US",
  "voiceKind": "Female"
}

Sample Response

Status code:

201

{
  "id": "Jessica-300",
  "description": "300 sentences Jessica data in general style.",
  "projectId": "Jessica",
  "locale": "en-US",
  "voiceKind": "Female",
  "status": "Succeeded",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Définitions

Nom	Description
Error	L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.
ErrorCode	Code d’erreur de niveau supérieur
ErrorResponse	La réponse d’erreur suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient le code d’erreur des propriétés requises, le message et les propriétés facultatives cible, erreur interne (cela peut être imbriqué).
Status	État d’une ressource.
TrainingSet	Jeu d’apprentissage
TrainingSetProperties	Propriétés du jeu d’entraînement
VoiceKind	Type de voix

Error

L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.

Nom	Type	Description
code	ErrorCode	Code d’erreur de niveau supérieur
details	Error[]	Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.
innererror	InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient le code d’erreur des propriétés requises, le message et les propriétés facultatives cible, erreur interne (cela peut être imbriqué).
message	string	Message d’erreur de niveau supérieur.
target	string	Source de l’erreur. Par exemple, il s’agirait de « modèle » ou « id de modèle » en cas de modèle non valide.

ErrorCode

Code d’erreur de niveau supérieur

Nom	Type	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

La réponse d’erreur suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
error	Error	L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.

InnerError

L’erreur interne suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient le code d’erreur des propriétés requises, le message et les propriétés facultatives cible, erreur interne (cela peut être imbriqué).

Nom	Type	Description
code	string	Code d’erreur détaillé pour faciliter le diagnostic.
innererror	InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui sont disponibles à l’adresse https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Il contient le code d’erreur des propriétés requises, le message et les propriétés facultatives cible, erreur interne (cela peut être imbriqué).
message	string	Message d’erreur détaillé.
target	string	Source de l’erreur. Par exemple, il s’agirait de « modèle » ou « id de modèle » en cas de modèle non valide.

Status

État d’une ressource.

Nom	Type	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

TrainingSet

Jeu d’apprentissage

Nom	Type	Description
createdDateTime	string	Horodatage lors 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).
description	string	Description du jeu d’entraînement
displayName	string	Nom du jeu d’entraînement
id	string	ID de la ressource
lastActionDateTime	string	Horodatage lorsque le status actuel a été entré. 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).
locale	string	Paramètres régionaux du jeu de données d’entraînement. Le code de paramètres régionaux suit BCP-47. Vous trouverez la liste des paramètres régionaux de synthèse vocale ici https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string	ID de la ressource
properties	TrainingSetProperties	Propriétés du jeu d’entraînement
status	Status	État d’une ressource.
voiceKind	VoiceKind	Type de voix

TrainingSetProperties

Propriétés du jeu d’entraînement

Nom	Type	Description
utteranceCount	integer	Nombre d’énoncés dans ce jeu d’entraînement

VoiceKind

Type de voix

Nom	Type	Description
Female	string
Male	string