Training Sets - Upload Data

Référence

Service:: Azure AI Services

Version d'API:: 2024-02-01-preview

Charge les données dans le jeu d’entraînement spécifié.

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

Paramètres URI

Nom Dans Obligatoire Type Description

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. 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.

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).

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

Nom Obligatoire Type Description

Ocp-Apim-Subscription-Key

True

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]$`

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]$

Corps de la demande

Nom	Obligatoire	Type	Description
audios	True	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
kind	True	DatasetKind	Type de jeu de données
description		string	Description facultative de ce jeu de données.
displayName		string	Nom de ce jeu de données.
scripts		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

Réponses

Nom	Type	Description
202 Accepted		Accepté 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

Nom

Type

Description

202 Accepted

Accepté

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

Upload data to a training set

Exemple de requête

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2024-02-01-preview



{
  "kind": "AudioAndScript",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

Exemple de réponse

Code d’état:: 202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

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
Dataset	Objet Dataset
DatasetKind	Type de jeu de données
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é).

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.

Dataset

Objet Dataset

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
description	string	Description facultative de ce jeu de données.
displayName	string	Nom de ce jeu de données.
kind	DatasetKind	Type de jeu de données
scripts	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

DatasetKind

Type de jeu de données

Nom	Type	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

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.

Partager via

Training Sets - Upload Data

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Sécurité

Ocp-Apim-Subscription-Key

Exemples

Upload data to a training set

Exemple de requête

Exemple de réponse

Définitions

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Ressources supplémentaires