Personal Voices - Post

Service:

Azure AI Services

Version d'API:

2024-02-01-preview

Crée une voix personnelle avec des fichiers audio dans le client.

POST {endpoint}/customvoice/personalvoices/{id}?api-version=2024-02-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
projectId	formData	True	string	ID de projet. Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
audioData	formData		file	Fichiers audio.
description	formData		string	Description facultative de ce modèle.
displayName	formData		string	Nom complet de ce modèle.
properties	formData		string	properties.
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. Modèle d’expression régulière: ^[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

Media Types: "multipart/form-data"

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string	Fournissez votre clé de ressource Speech ici.
Operation-Id		string	ID du moniteur d’état de l’opération. Si l’en-tête Operation-Id correspond à une opération existante et que la demande n’est pas identique à la demande précédente, elle échoue avec une requête incorrecte 400. Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Réponses

Nom	Type	Description
201 Created	PersonalVoice	Date de création En-têtes Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Une erreur est survenue. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Fournissez votre clé de ressource Speech ici.

Type: apiKey
Dans: header

Exemples

Create a personal voice

Exemple de requête

HTTP

POST {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2024-02-01-preview

Exemple de réponse

Code d’état:

201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2024-02-01-preview
Operation-Id: 1321a2c0-9be4-471d-83bb-bc3be4f96a6f

{
  "id": "Jessica-PersonalVoice",
  "speakerProfileId": "3059912f-a3dc-49e3-bdd0-02e449df1fe3",
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Définitions

Nom	Description
AzureBlobContentSource	Contenu du Stockage Blob Azure. Avec les exemples ci-dessous, il représente les fichiers https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	L’erreur de niveau supérieur suit les instructions relatives à l’API REST Microsoft Azure, 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, 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 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, l’erreur interne (cela peut être imbriqué).
ModelFailureReason	Raison de l’échec de l’entraînement du modèle
PersonalVoice	Objet vocal personnel
PersonalVoiceProperties	Propriétés vocales personnelles
Status	État d’une ressource.

AzureBlobContentSource

Contenu du Stockage Blob Azure. Avec les exemples ci-dessous, il représente les fichiers https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nom	Type	Description
containerUrl	string	URL du conteneur Stockage Blob Azure avec SAP. Vous avez besoin d’autorisations de lecture et de liste.
extensions	string[]	Extensions de nom de fichier.
prefix	string	Préfixe de nom d’objet blob.

Error

L’erreur de niveau supérieur suit les instructions relatives à l’API REST Microsoft Azure, 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 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, l’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 « model » ou de « model ID » 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, 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 relatives à l’API REST Microsoft Azure, 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 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, l’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 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, l’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 « model » ou de « model ID » en cas de modèle non valide.

ModelFailureReason

Raison de l’échec de l’entraînement du modèle

Nom	Type	Description
InaccessibleCustomerStorage	string	Le client utilise Bring Your Own Storage dans le compte Speech. Mais le stockage n’est pas accessible pour l’instant. Veuillez consulter la documentation.
Internal	string	Erreur du service vocal personnalisé.
SpeakerVerificationFailed	string	Le consentement et l’audio d’entraînement ne proviennent pas du même haut-parleur.
TerminateByUser	string	Le client a annulé l’entraînement du modèle.

PersonalVoice

Objet vocal personnel

Nom	Type	Description
audios	AzureBlobContentSource	Contenu du Stockage Blob Azure. Avec les exemples ci-dessous, il représente les fichiers https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string	ID de la ressource
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 vocale personnelle
displayName	string	Nom d’affichage de la voix personnelle
id	string	ID de la ressource
lastActionDateTime	string	Horodatage lorsque l’état 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).
projectId	string	ID de la ressource
properties	PersonalVoiceProperties	Propriétés vocales personnelles
speakerProfileId	string	ID de profil de haut-parleur vocal personnel. Renseignez cette propriété dans SSML.
status	Status	État d’une ressource.

PersonalVoiceProperties

Propriétés vocales personnelles

Nom	Type	Description
failureReason	ModelFailureReason	Raison de l’échec de l’entraînement du modèle

Status

État d’une ressource.

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