Personal Voices - Create

Referencia

Service:: Azure AI Services

API Version:: 2023-12-01-preview

Crea una nueva voz personal con archivos de audio en Azure Blob Storage.

PUT {endpoint}/customvoice/personalvoices/{id}?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. Regex pattern: `^[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.

Regex pattern: ^[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 del 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. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Proporcione la clave del 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.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
consentId	True	string	Identificador de recurso
projectId	True	string	Identificador de recurso
audios		AzureBlobContentSource	Azure Blob Storage contenido. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description		string	Descripción de voz personal
displayName		string	Nombre para mostrar de voz personal
id		string	Identificador de recurso
status		Status	Estado de un recurso.

Respuestas

Nombre	Tipo	Description
201 Created	PersonalVoice	Creado Headers Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Se produjo un error.

Nombre

Tipo

Description

201 Created

PersonalVoice

Creado

Headers

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Se produjo un error.

Seguridad

Ocp-Apim-Subscription-Key

Proporcione la clave del recurso de voz aquí.

Type: apiKey
In: header

Ejemplos

Create a personal voice

Sample Request

HTTP

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



{
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica/",
    "extensions": [
      ".wav"
    ]
  }
}

Sample Response

Status code:: 201

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

Response Body

{
  "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"
}

Definiciones

Nombre	Description
AzureBlobContentSource	Azure Blob Storage contenido. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	El error de nivel superior se rige por 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 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 el código de error de las propiedades necesarias, el mensaje y el destino de las propiedades opcionales, error interno (se puede anidar).
ModelFailureReason	Motivo del error de entrenamiento del modelo
PersonalVoice	Objeto de voz personal
PersonalVoiceProperties	Propiedades de voz personal
Status	Estado de un recurso.

AzureBlobContentSource

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

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

Error

El error de nivel superior se rige por 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 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 el código de error de las propiedades necesarias, el mensaje y el destino de las propiedades opcionales, error interno (se puede anidar).
message	string	Mensaje de error de nivel superior.
target	string	Origen del error. Por ejemplo, sería "model" o "model id" 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 se rige por 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 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 el código de error de las propiedades necesarias, el mensaje y el destino de las propiedades opcionales, error interno (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 el código de error de las propiedades necesarias, el mensaje y el destino de las propiedades opcionales, error interno (se puede anidar).
message	string	Mensaje de error detallado.
target	string	Origen del error. Por ejemplo, sería "model" o "model id" en caso de modelo no válido.

ModelFailureReason

Motivo del error de entrenamiento del modelo

Nombre	Tipo	Description
InaccessibleCustomerStorage	string
Internal	string
None	string
SpeakerVerificationFailed	string
TerminateByUser	string

PersonalVoice

Objeto de voz personal

Nombre	Tipo	Description
audios	AzureBlobContentSource	Azure Blob Storage contenido. Con los ejemplos siguientes, representa los archivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string	Identificador de recurso
createdDateTime	string	Marca de tiempo cuando se creó el objeto. La marca de tiempo se codifica como formato de fecha y hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", vea https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descripción de voz personal
displayName	string	Nombre para mostrar de voz personal
id	string	Identificador de recurso
lastActionDateTime	string	Marca de tiempo cuando se especificó el estado actual. La marca de tiempo se codifica como formato de fecha y hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", vea https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId	string	Identificador de recurso
properties	PersonalVoiceProperties	Propiedades de voz personal
speakerProfileId	string	Identificador de perfil del hablante de voz personal. Rellene esta propiedad en SSML.
status	Status	Estado de un recurso.

PersonalVoiceProperties

Propiedades de voz personal

Nombre	Tipo	Description
failureReason	ModelFailureReason	Motivo del error de entrenamiento del modelo

Status

Estado de un recurso.

Nombre	Tipo	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Compartir a través de

Personal Voices - Create

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Create a personal voice

Sample Request

Sample Response

Definiciones

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Recursos adicionales