Models - List Recipes

Referência

Serviço:: Azure AI Services

Versão da API:: 2024-02-01-preview

Obtenha uma lista de receitas com suporte para a criação de modelos. Receitas diferentes têm recursos diferentes, como suporte para modelos de voz de vários estilos.

GET {endpoint}/customvoice/modelrecipes?api-version=2024-02-01-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://eastus.api.cognitive.microsoft.com).
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Forneça sua chave de recurso de Fala aqui.

Respostas

Nome	Tipo	Description
200 OK	Recipe[]	Êxito
Other Status Codes	ErrorResponse	Ocorreu um erro. Cabeçalhos x-ms-error-code: string

Nome

Tipo

Description

200 OK

Recipe[]

Êxito

Other Status Codes

ErrorResponse

Ocorreu um erro.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Forneça sua chave de recurso de Fala aqui.

Tipo: apiKey
Em: header

Exemplos

Get all recipes

Solicitação de exemplo

HTTP

GET {endpoint}/customvoice/modelrecipes?api-version=2024-02-01-preview

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "version": "V7.2023.03",
      "kind": "Default",
      "description": "Model updated with a robust vocoder for higher audio quality. 15-50 compute hours estimated for each training.",
      "minUtteranceCount": 300,
      "datasetLocales": [
        "en-US",
        "en-GB",
        "fr-FR",
        "it-IT"
      ]
    },
    {
      "version": "V3.2023.06",
      "kind": "MultiStyle",
      "description": "Basic version to adapt the voice to speak with multiple emotional styles, or create your own speaking style with custom style training data. 25-50 computer hours estimated for each training. Style degree tuning supported.",
      "minUtteranceCount": 300,
      "minStyleUtteranceCount": 100,
      "maxCustomStyleNum": 5,
      "datasetLocales": [
        "en-US",
        "ja-JP"
      ],
      "presetStyles": {
        "en-US": {
          "Male": [
            "angry",
            "excited",
            "cheerful",
            "friendly",
            "hopeful",
            "sad",
            "shouting",
            "terrified",
            "unfriendly",
            "whispering"
          ],
          "Female": [
            "angry",
            "excited",
            "cheerful",
            "friendly",
            "hopeful",
            "sad",
            "shouting",
            "terrified",
            "unfriendly",
            "whispering"
          ]
        },
        "ja-JP": {
          "Male": [
            "angry",
            "cheerful",
            "sad"
          ],
          "Female": [
            "angry",
            "cheerful",
            "sad"
          ]
        }
      }
    }
  ]
}

Definições

Nome	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. Isso 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 de erro 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. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).
PresetStyleItem	Estilos predefinidos compatíveis com a receita. O modelo de voz pode dar suporte a esses estilos sem nenhum conjunto de treinamento de estilo.
Recipe	Receita para a criação de modelos. Receitas diferentes têm capacidade diferente.

Error

Objeto

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. Isso contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

Nome	Tipo	Description
code	ErrorCode	Código de erro de nível superior
details	Error[]	Detalhes adicionais de suporte 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. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso 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

Enumeração

Código de erro de nível superior

Valor	Description
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Objeto

A resposta de erro 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.

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

Objeto

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. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).

Nome	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. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso 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.

PresetStyleItem

Objeto

Estilos predefinidos compatíveis com a receita. O modelo de voz pode dar suporte a esses estilos sem nenhum conjunto de treinamento de estilo.

Nome	Tipo	Description
female	string[]	Estilos predefinidos compatíveis com o modelo de voz feminina.
male	string[]	Estilos predefinidos compatíveis com o modelo de voz masculina.

Recipe

Objeto

Receita para a criação de modelos. Receitas diferentes têm capacidade diferente.

Nome	Tipo	Description
datasetLocales	string[]	A localidade do conjunto de dados de treinamento. O código de localidade segue BCP-47. Você pode encontrar a lista de localidades de texto em fala 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 (int32)	Número máximo de estilo personalizado com suporte em um modelo de voz.
minStyleUtteranceCount	integer (int32)	Contagem mínima de enunciados necessária para treinar cada estilo personalizado.
minUtteranceCount	integer (int32)	Contagem mínima de enunciados necessária para treinar um modelo de voz com esta receita.
modelLocales	string[]	A localidade que um modelo de voz pode falar com essa receita. O código de localidade segue BCP-47. Você pode encontrar a lista de localidades de texto em fala aqui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
presetStyles	<string, PresetStyleItem>	Estilos predefinidos compatíveis com essa receita por localidade. Você pode obter esses estilos sem nenhum conjunto de treinamento de estilo.
version	string	Versão da receita

Compartilhar via

Models - List Recipes

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Get all recipes

Solicitação de exemplo

Resposta de exemplo

Definições

Error

ErrorCode

ErrorResponse

InnerError

PresetStyleItem

Recipe