Training Sets - Upload Data

Referencia

Servicio:: Cognitive Services - Custom Voice

Versión de la API:: 2023-12-01-preview

Carga datos en el conjunto de entrenamiento especificado.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Identificador del recurso. Patrón de Regex: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Versión de API que se usará para la operación.

endpoint

path

True

string

Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://eastus.api.cognitive.microsoft.com).

path

True

string

Identificador del recurso.

Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

Versión de API que se usará para la operación.

Encabezado de la solicitud

Nombre Requerido Tipo Description

Ocp-Apim-Subscription-Key

True

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Proporcione la clave de recurso de Voz aquí.
Operation-Id		string	Identificador del monitor de estado de la operación. Si el encabezado Operation-Id coincide con una operación existente y la solicitud no es idéntica a la solicitud anterior, se producirá un error con una solicitud incorrecta 400. Patrón de Regex: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Proporcione la clave de recurso de Voz aquí.

Operation-Id

string

Identificador del monitor de estado de la operación. Si el encabezado Operation-Id coincide con una operación existente y la solicitud no es idéntica a la solicitud anterior, se producirá un error con una solicitud incorrecta 400.

Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
audios	True	AzureBlobContentSource	Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Tipo de conjunto de datos
description		string	Descripción opcional de este conjunto de datos.
displayName		string	Nombre de este conjunto de datos.
scripts		AzureBlobContentSource	Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Respuestas

Nombre	Tipo	Description
202 Accepted		Aceptado Encabezados Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Se produjo un error.

Nombre

Tipo

Description

202 Accepted

Aceptado

Encabezados

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Se produjo un error.

Seguridad

Ocp-Apim-Subscription-Key

Proporcione la clave de recurso de Voz aquí.

Tipo: apiKey
En: header

Ejemplos

Upload data to a training set

Sample request

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2023-12-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"
    ]
  }
}

Sample response

Status code:: 202

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

Definiciones

Nombre	Description
AzureBlobContentSource	Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Objeto Conjunto de datos
DatasetKind	Tipo de conjunto de datos
Error	El error de nivel superior sigue las directrices de la API REST de Microsoft Azure que están disponibles en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un error de nivel superior con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.
ErrorCode	Código de error de nivel superior
ErrorResponse	La respuesta de error sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	El error interno sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene código de error de propiedades necesarias, mensaje y destino de propiedades opcionales, error interno (esto se puede anidar).

AzureBlobContentSource

Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nombre	Tipo	Description
containerUrl	string	Dirección URL del contenedor de Azure Blob Storage con SAS. Necesita permisos de lectura y lista.
extensions	string[]	Extensiones de nombre de archivo.
prefix	string	Prefijo de nombre de blob.

Dataset

Objeto Conjunto de datos

Nombre	Tipo	Description
audios	AzureBlobContentSource	Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Descripción opcional de este conjunto de datos.
displayName	string	Nombre de este conjunto de datos.
kind	DatasetKind	Tipo de conjunto de datos
scripts	AzureBlobContentSource	Contenido de Azure Blob Storage. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Tipo de conjunto de datos

Nombre	Tipo	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

El error de nivel superior sigue las directrices de la API REST de Microsoft Azure que están disponibles en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un error de nivel superior con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.

Nombre	Tipo	Description
code	ErrorCode	Código de error de nivel superior
details	Error[]	Detalles adicionales de apoyo relacionados con el error o las directivas esperadas.
innererror	InnerError	El error interno sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene código de error de propiedades necesarias, mensaje y destino de propiedades opcionales, error interno (esto se puede anidar).
message	string	Mensaje de error de nivel superior.
target	string	Origen del error. Por ejemplo, sería "model" o "id. de modelo" en caso de modelo no válido.

ErrorCode

Código de error de nivel superior

Nombre	Tipo	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

La respuesta de error sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nombre	Tipo	Description
error	Error	El error de nivel superior sigue las directrices de la API REST de Microsoft Azure que están disponibles en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un error de nivel superior con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.

InnerError

El error interno sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene código de error de propiedades necesarias, mensaje y destino de propiedades opcionales, error interno (esto se puede anidar).

Nombre	Tipo	Description
code	string	Código de error detallado para ayudar al diagnóstico.
innererror	InnerError	El error interno sigue las directrices de la API REST de Microsoft Azure que está disponible en https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene código de error de propiedades necesarias, mensaje y destino de propiedades opcionales, error interno (esto se puede anidar).
message	string	Mensaje de error detallado.
target	string	Origen del error. Por ejemplo, sería "model" o "id. de modelo" en caso de modelo no válido.

Compartir a través de

Training Sets - Upload Data

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Upload data to a training set

Sample request

Sample response

Definiciones

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Recursos adicionales