Partilhar via


Personal Voices - Post

Cria uma nova voz pessoal com ficheiros de áudio no cliente.

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

Parâmetros do URI

Name Em Necessário Tipo Description
projectId
formData True

string

O ID do projeto.

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

audioData
formData

file

Ficheiros de áudio.

description
formData

string

Descrição opcional deste modelo.

displayName
formData

string

O nome a apresentar deste modelo.

properties
formData

string

propriedades.

endpoint
path True

string

Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://eastus.api.cognitive.microsoft.com).

id
path True

string

O ID do recurso.

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

api-version
query True

string

A versão da API a utilizar para esta operação.

Cabeçalho do Pedido

Media Types: "multipart/form-data"

Name Necessário Tipo Description
Ocp-Apim-Subscription-Key True

string

Forneça a sua chave de recurso de Voz aqui.

Operation-Id

string

ID do monitor de estado da operação. Se o cabeçalho Operation-Id corresponder a uma operação existente e o pedido não for idêntico ao pedido anterior, falhará com um Pedido Incorreto 400.

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

Respostas

Name Tipo Description
201 Created

PersonalVoice

Criado

Cabeçalhos

  • Operation-Id: string
  • Operation-Location: string
Other Status Codes

ErrorResponse

Ocorreu um erro.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Forneça a sua chave de recurso de Voz aqui.

Tipo: apiKey
Em: header

Exemplos

Create a personal voice

Pedido de amostra

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


Resposta da amostra

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

Definições

Name Description
AzureBlobContentSource

Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, representa ficheiros https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Error

O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

ErrorCode

Código de erro de nível superior

ErrorResponse

A resposta a erros segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

InnerError

O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém o código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isto pode ser aninhado).

ModelFailureReason

Motivo da falha de preparação de modelos

PersonalVoice

Objeto de voz pessoal

PersonalVoiceProperties

Propriedades de voz pessoal

Status

Estado de um recurso.

AzureBlobContentSource

Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, representa ficheiros https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name Tipo Description
containerUrl

string

URL do contentor do Armazenamento de Blobs do Azure com SAS. Precisa de permissões de leitura e de lista.

extensions

string[]

Extensões de nome de ficheiro.

prefix

string

Prefixo do nome do blob.

Error

O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

Name Tipo Description
code

ErrorCode

Código de erro de nível superior

details

Error[]

Detalhes de suporte adicionais sobre o erro e/ou as políticas esperadas.

innererror

InnerError

O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém o código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isto pode ser aninhado).

message

string

Mensagem de erro de nível superior.

target

string

A origem do erro. Por exemplo, seria "model" ou "model id" em caso de modelo inválido.

ErrorCode

Código de erro de nível superior

Name Tipo Description
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

A resposta a erros segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name Tipo Description
error

Error

O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

InnerError

O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém o código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isto pode ser aninhado).

Name Tipo Description
code

string

Código de erro detalhado para ajudar no diagnóstico.

innererror

InnerError

O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isto contém o código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isto pode ser aninhado).

message

string

Mensagem de erro detalhada.

target

string

A origem do erro. Por exemplo, seria "model" ou "model id" em caso de modelo inválido.

ModelFailureReason

Motivo da falha de preparação de modelos

Name Tipo Description
InaccessibleCustomerStorage

string

O cliente utiliza Bring Your Own Storage na Conta de Voz. Mas o armazenamento não está acessível agora. Verifique o documento.

Internal

string

Erro do Serviço de Voz Personalizado.

SpeakerVerificationFailed

string

O consentimento e o áudio de preparação não são do mesmo orador.

TerminateByUser

string

O cliente cancelou a preparação do modelo.

PersonalVoice

Objeto de voz pessoal

Name Tipo Description
audios

AzureBlobContentSource

Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, representa ficheiros https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

consentId

string

ID do recurso

createdDateTime

string

O carimbo de data/hora quando o objeto foi criado. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

description

string

Descrição pessoal da voz

displayName

string

Nome a apresentar da voz pessoal

id

string

ID do recurso

lastActionDateTime

string

O carimbo de data/hora quando o estado atual foi introduzido. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

projectId

string

ID do recurso

properties

PersonalVoiceProperties

Propriedades de voz pessoal

speakerProfileId

string

ID de perfil de orador de voz pessoal. Preencha esta propriedade no SSML.

status

Status

Estado de um recurso.

PersonalVoiceProperties

Propriedades de voz pessoal

Name Tipo Description
failureReason

ModelFailureReason

Motivo da falha de preparação de modelos

Status

Estado de um recurso.

Name Tipo Description
Disabled

string

Disabling

string

Failed

string

NotStarted

string

Running

string

Succeeded

string