Models - Create

Referência

Service:: Cognitive Services - Custom Voice

API Version:: 2023-12-01-preview

Cria um novo modelo de voz.

PUT {endpoint}/customvoice/models/{id}?api-version=2023-12-01-preview

Parâmetros do URI

Name Em Necessário Tipo Description

Name	Em	Necessário	Tipo	Description
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. Regex pattern: `^[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.

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

path

True

string

O ID do recurso.

Regex pattern: ^[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

Name Necessário Tipo Description

Ocp-Apim-Subscription-Key

True

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

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.

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

Corpo do Pedido

Name	Necessário	Tipo	Description
consentId	True	string	ID do recurso
projectId	True	string	ID do recurso
recipe	True	Recipe	Receita para a criação de modelos. Diferentes receitas têm uma capacidade diferente.
trainingSetId	True	string	ID do recurso
description		string	Descrição do modelo
id		string	ID do recurso
locale		string	A região deste modelo. O código de região segue BCP-47. Pode encontrar a lista de região de texto para voz aqui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
properties		ModelProperties	Propriedades do modelo
status		Status	Estado de um recurso.
voiceName		string	Nome da voz

Respostas

Name	Tipo	Description
201 Created	Model	Criado Headers Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ocorreu um erro.

Name

Tipo

Description

201 Created

Model

Criado

Headers

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Ocorreu um erro.

Segurança

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

Exemplos

Create a model

Create a multi style model

Create a model

Sample Request

HTTP

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



{
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300"
}

Sample Response

Status code:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1f4352df-f247-40c0-a7b1-a54d017933e1?api-version=2023-12-01-preview
Operation-Id: 1f4352df-f247-40c0-a7b1-a54d017933e1

Response Body

{
  "id": "Jessica",
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default",
    "version": "V7.2023.03"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Create a multi style model

Sample Request

HTTP

PUT {endpoint}/customvoice/models/JessicaMultiStyle?api-version=2023-12-01-preview



{
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    }
  }
}

Sample Response

Status code:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/a01a127a-c204-4e46-a8c1-fab01559b05b?api-version=2023-12-01-preview
Operation-Id: a01a127a-c204-4e46-a8c1-fab01559b05b

Response Body

{
  "id": "JessicaMultiStyle",
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle",
    "version": "V3.2023.06"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    },
    "voiceStyles": [
      "cheerful",
      "sad",
      "happy",
      "myStyle2"
    ]
  },
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Definições

Name	Description
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).
Model	Objeto de modelo
ModelFailureReason	Motivo da falha de preparação de modelos
ModelProperties	Propriedades do modelo
PresetStyleItem	Estilos predefinidos suportados pela receita. O modelo de voz pode suportar estes estilos sem qualquer conjunto de preparação de estilos.
Recipe	Receita para a criação de modelos. Diferentes receitas têm uma capacidade diferente.
Status	Estado de um recurso.

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.

Model

Objeto de modelo

Name	Tipo	Description
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 do modelo
engineVersion	string	Versão do motor. Atualizar esta versão pode obter a correção de erros de pronúncia mais recente.
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).
locale	string	A região deste modelo. O código de região segue BCP-47. Pode encontrar a lista de região de texto para voz aqui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string	ID do recurso
properties	ModelProperties	Propriedades do modelo
recipe	Recipe	Receita para a criação de modelos. Diferentes receitas têm uma capacidade diferente.
status	Status	Estado de um recurso.
trainingSetId	string	ID do recurso
voiceName	string	Nome da voz

ModelFailureReason

Motivo da falha de preparação de modelos

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

ModelProperties

Propriedades do modelo

Name	Tipo	Description
failureReason	ModelFailureReason	Motivo da falha de preparação de modelos
presetStyles	string[]	Estilos predefinidos deste modelo.
styleTrainingSetIds	object	Estilos personalizados e conjuntos de preparação associados.
voiceStyles	string[]	Todos os estilos suportados por este modelo.

PresetStyleItem

Estilos predefinidos suportados pela receita. O modelo de voz pode suportar estes estilos sem qualquer conjunto de preparação de estilos.

Name	Tipo	Description
female	string[]	Estilos predefinidos suportados no modelo de voz feminina.
male	string[]	Estilos predefinidos suportados no modelo de voz masculino.

Recipe

Receita para a criação de modelos. Diferentes receitas têm uma capacidade diferente.

Name	Tipo	Description
datasetLocales	string[]	A região do conjunto de dados de preparação. O código de região segue BCP-47. Pode encontrar a lista de região de texto para voz aqui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
description	string	Descrição da receita
kind	string	Tipo de receita
maxCustomStyleNum	integer	Número máximo de estilo personalizado suportado num modelo de voz.
minStyleUtteranceCount	integer	Contagem mínima de expressões necessária para preparar cada estilo personalizado.
minUtteranceCount	integer	Contagem mínima de expressões necessária para preparar um modelo de voz com esta receita.
modelLocales	string[]	A região em que um modelo de voz pode falar com esta receita. O código de região segue BCP-47. Pode encontrar a lista de região de texto para voz aqui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
presetStyles	<string, PresetStyleItem>	Estilos predefinidos suportados por esta receita por região. Pode obter estes estilos sem qualquer conjunto de preparação de estilos.
version	string	Versão da receita

Status

Estado de um recurso.

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

Models - Create

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Create a model

Sample Request

Sample Response

Create a multi style model

Sample Request

Sample Response

Definições

Error

ErrorCode

ErrorResponse

InnerError

Model

ModelFailureReason

ModelProperties

PresetStyleItem

Recipe

Status

Recursos adicionais