Models - Get

Servicio:: Azure AI Services

Versión de la API:: 2026-01-01

Obtiene el modelo identificado por el identificador especificado.

GET {endpoint}/customvoice/models/{id}?api-version=2026-01-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identificador de recurso
api-version	query	True	string minLength: 1	La versión de API que se va a utilizar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	Model	La solicitud se ha realizado correctamente.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

Model

La solicitud se ha realizado correctamente.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
https://cognitiveservices.azure.com/.default

Ejemplos

Get a model

Solicitud de ejemplo

HTTP

GET {endpoint}/customvoice/models/Jessica?api-version=2026-01-01

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de Azure API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Model	Model (objeto)
ModelFailureReason	Razón de fallo en el entrenamiento del modelo
ModelProperties	Propiedades del modelo
PresetStyleItem	Estilos predefinidos apoyados por la receta. El modelo de voz puede soportar estos estilos sin ningún conjunto de entrenamiento de estilos.
Recipe	Receta para la construcción de maquetas. Diferentes recetas tienen diferentes capacidades.
Status	Estado de un recurso.

Azure.Core.Foundations.Error

Objeto

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Objeto

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Objeto

Objeto que contiene información más específica sobre el error. Según las directrices de Azure API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

Model

Objeto

Model (objeto)

Nombre	Tipo	Description
consentId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identificador de recurso
createdDateTime	string (date-time)	La marca de tiempo en la que se creó el objeto. La marca de tiempo está codificada como formato de fecha y hora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", véase https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descripción del modelo
engineVersion	string	Versión del motor. Actualizar esta versión puede corregir el último error de pronunciación.
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identificador de recurso
lastActionDateTime	string (date-time)	La marca de tiempo en la que se introdujo el estado actual. La marca de tiempo está codificada como formato de fecha y hora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", véase https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	La ubicación de este modelo. El código local sigue a BCP-47. Puedes encontrar la lista de localizaciones de texto a voz aquí https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identificador de recurso
properties	ModelProperties	Propiedades del modelo
recipe	Recipe	Receta para la construcción de maquetas. Diferentes recetas tienen diferentes capacidades.
status	Status	Estado de un recurso.
trainingSetId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identificador de recurso
voiceName	string minLength: 1	Nombre de voz

ModelFailureReason

Enumeración

Razón de fallo en el entrenamiento del modelo

Valor	Description
InaccessibleCustomerStorage	El cliente utiliza la cuenta Bring Your Own Storage in Speech. Pero el almacenamiento ya no es accesible. Por favor, consulta el doctor.
SpeakerVerificationFailed	El consentimiento y el audio de la formación no provienen del mismo altavoz.
TerminateByUser	El cliente canceló el entrenamiento de modelos.
Internal	Error en el servicio de voz personalizado.
DataNotReady	Los datos de entrenamiento no están listos para el entrenamiento de modelos.
DataNotEnough	Los datos de entrenamiento no son suficientes para el entrenamiento de modelos.

ModelProperties

Objeto

Propiedades del modelo

Nombre	Tipo	Description
failedTrainingsets	string[]	IDs de conjuntos de entrenamiento fallidos.
failureReason	ModelFailureReason	Razón de fallo en el entrenamiento del modelo
presetStyles	string[]	Estilos predefinidos de este modelo.
secondaryLocales	string[]	Lugares secundarios que este modelo puede mencionar. El código local sigue a BCP-47.
styleTrainingSetIds	object	Estilos personalizados y conjuntos de entrenamiento asociados.
voiceStyles	string[]	Todos los estilos soportados por este modelo.

PresetStyleItem

Objeto

Estilos predefinidos apoyados por la receta. El modelo de voz puede soportar estos estilos sin ningún conjunto de entrenamiento de estilos.

Nombre	Tipo	Description
female	string[]	Estilos predefinidos soportados en modelo de voz femenina.
male	string[]	Estilos predefinidos soportados en modelos de voz masculina.

Recipe

Objeto

Receta para la construcción de maquetas. Diferentes recetas tienen diferentes capacidades.

Nombre	Tipo	Description
datasetLocales	string[]	La ubicación del conjunto de datos de entrenamiento. El código local sigue a BCP-47. Puedes encontrar la lista de localizaciones de texto a voz aquí https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
description	string	Descripción de la receta
kind	string	Tipo de receta
maxCustomStyleNum	integer (int32)	Número máximo de estilo personalizado soportado en el modelo de una sola voz.
minDurationInSeconds	number (double)	Duración mínima de audio en segundos necesaria para entrenar un modelo de voz con esta receta.
minStyleUtteranceCount	integer (int32)	Mínimo de palabras requeridas para entrenar cada estilo personalizado.
minUtteranceCount	integer (int32)	Mínimo de palabras requeridas para entrenar un modelo de voz con esta receta.
modelLocales	string[]	El lugar donde un modelo de voz puede comunicarse con esta receta. El código local sigue a BCP-47. Puedes encontrar la lista de localizaciones de texto a voz aquí https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
presetStyles	<string, PresetStyleItem>	Estilos predefinidos apoyados por esta receta según la zona. Puedes conseguir estos estilos sin ningún set de entrenamiento de estilo.
version	string	Versión de la receta

Status

Enumeración

Estado de un recurso.

Valor	Description
NotStarted	No iniciado
Running	Correr
Succeeded	Succeeded
Failed	Fallido
Disabling	Desactivación
Disabled	Deshabilitado