Models - Create

Servicio:: Azure AI Services

Versión de la API:: v3.2-preview.2

Crea un nuevo modelo.

POST {endpoint}/speechtotext/v3.2-preview.2/models

Parámetros de identificador URI

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://westus.api.cognitive.microsoft.com).

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
displayName	True	string minLength: 1	Nombre para mostrar del objeto.
locale	True	string minLength: 1	Configuración regional de los datos contenidos.
baseModel		EntityReference	EntityReference
customProperties		object	Propiedades personalizadas de esta entidad. La longitud máxima de clave permitida es de 64 caracteres, la longitud máxima permitida del valor es de 256 caracteres y el recuento de entradas permitidas es de 10.
datasets		EntityReference[]	Conjuntos de datos usados para la adaptación.
description		string	Descripción del objeto.
project		EntityReference	EntityReference
properties		CustomModelProperties	CustomModelProperties
text		string	Texto usado para adaptar este modelo de lenguaje.

Respuestas

Nombre	Tipo	Description
201 Created	CustomModel	La respuesta contiene información sobre la entidad como carga y su ubicación como encabezado. Encabezados Location: string
Other Status Codes	Error	Se ha producido un error.

Nombre

Tipo

Description

201 Created

CustomModel

La respuesta contiene información sobre la entidad como carga y su ubicación como encabezado.

Encabezados

Location: string

Other Status Codes

Error

Se ha producido un error.

Seguridad

Ocp-Apim-Subscription-Key

Proporcione aquí la clave de la cuenta de Cognitive Services.

Tipo: apiKey
En: header

Authorization

Proporcione un token de acceso del JWT devuelto por el STS de esta región. Asegúrese de agregar el ámbito de administración al token agregando la siguiente cadena de consulta a la dirección URL de STS: ?scope=speechservicesmanagement

Tipo: apiKey
En: header

Ejemplos

Create a model

Create a model with custom model weight

Create a model

Solicitud de ejemplo

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/models

{
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "locale": "en-US",
  "displayName": "Model with acoustic and language datasets"
}

Respuesta de muestra

status code:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b",
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "links": {
    "manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
    "copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
    "copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
  },
  "properties": {
    "deprecationDates": {
      "transcriptionDateTime": "2023-05-04T00:00:00Z"
    },
    "customModelWeightPercent": 30,
    "features": {
      "supportsTranscriptions": true,
      "supportsEndpoints": true,
      "supportsTranscriptionsOnSpeechContainers": false,
      "supportedOutputFormats": [
        "Lexical",
        "Display"
      ]
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Running",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Language model",
  "description": "This is a language model"
}

Create a model with custom model weight

Solicitud de ejemplo

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/models

{
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "properties": {
    "customModelWeightPercent": 42
  },
  "locale": "en-US",
  "displayName": "Model with acoustic and language datasets"
}

Respuesta de muestra

status code:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b",
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "links": {
    "manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
    "copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
    "copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
  },
  "properties": {
    "deprecationDates": {
      "transcriptionDateTime": "2023-05-04T00:00:00Z"
    },
    "customModelWeightPercent": 42,
    "features": {
      "supportsTranscriptions": true,
      "supportsEndpoints": true,
      "supportsTranscriptionsOnSpeechContainers": false,
      "supportedOutputFormats": [
        "Lexical",
        "Display"
      ]
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Running",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Language model",
  "description": "This is a language model"
}

Definiciones

Nombre	Description
CustomModel	CustomModel
CustomModelDeprecationDates	CustomModelDeprecationDates
CustomModelFeatures	CustomModelFeatures
CustomModelLinks	CustomModelLinks
CustomModelProperties	CustomModelProperties
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Error
ErrorCode	ErrorCode
InnerError	InnerError
OutputFormatType	OutputFormatType
Status	Estado

CustomModel

Object

CustomModel

Nombre	Tipo	Description
baseModel	EntityReference	EntityReference
createdDateTime	string (date-time)	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).
customProperties	object	Propiedades personalizadas de esta entidad. La longitud máxima de clave permitida es de 64 caracteres, la longitud máxima permitida del valor es de 256 caracteres y el recuento de entradas permitidas es de 10.
datasets	EntityReference[]	Conjuntos de datos usados para la adaptación.
description	string	Descripción del objeto.
displayName	string minLength: 1	Nombre para mostrar del objeto.
lastActionDateTime	string (date-time)	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).
links	CustomModelLinks	CustomModelLinks
locale	string minLength: 1	Configuración regional de los datos contenidos.
project	EntityReference	EntityReference
properties	CustomModelProperties	CustomModelProperties
self	string (uri)	Ubicación de esta entidad.
status	Status	Estado Describir el estado actual de la API
text	string	Texto usado para adaptar este modelo de lenguaje.

CustomModelDeprecationDates

Object

CustomModelDeprecationDates

Nombre	Tipo	Description
transcriptionDateTime	string (date-time)	Fecha en que la transcripción queda en desuso.

CustomModelFeatures

Object

CustomModelFeatures

Nombre	Tipo	Description
supportedOutputFormats	OutputFormatType[]	Formatos de salida admitidos.
supportsEndpoints	boolean	Valor que indica si se admite la creación de puntos de conexión para la transcripción en directo.
supportsTranscriptions	boolean	Valor que indica si se admite la transcripción por lotes.
supportsTranscriptionsOnSpeechContainers	boolean	Valor que indica si este modelo se puede usar para la transcripción en el contenedor de voz. Esta característica se puede agregar en los modelos existentes cuando se puede usar en el contenedor de voz.

CustomModelLinks

Object

CustomModelLinks

Nombre	Tipo	Description
copy	string (uri)	Ubicación de la acción de copia del modelo. Consulte la operación "Models_Copy" para obtener más información.
copyTo	string (uri)	Ubicación de la acción de copia del modelo obsoleto. Consulte la operación "Models_CopyTo" para obtener más detalles.
files	string (uri)	Ubicación para obtener todos los archivos de esta entidad. Consulte la operación "Models_ListFiles" para obtener más detalles.
manifest	string (uri)	Ubicación para obtener un manifiesto para este modelo que se va a usar en el contenedor local. Consulte la operación "Models_GetCustomModelManifest" para obtener más detalles.

CustomModelProperties

Object

CustomModelProperties

Nombre	Tipo	Description
customModelWeightPercent	integer (int32) minimum: 1 maximum: 100	Peso del modelo personalizado entre 1 (1% modelo personalizado y 99% modelo base) y 100 (100% modelo personalizado y 0% modelo base). Cuando no se establece esta propiedad, el servicio elige un valor adecuado (obtenga el modelo para recuperar el peso seleccionado). Empiece sin usar esta propiedad. Si es necesario, elija un peso mayor (o menor) para aumentar (o disminuir) el impacto del modelo personalizado.
deprecationDates	CustomModelDeprecationDates	CustomModelDeprecationDates
email	string	La dirección de correo electrónico a la que enviar notificaciones por correo electrónico en caso de que se complete la operación. El valor se quitará después de enviar correctamente el correo electrónico.
error	EntityError	EntityError
features	CustomModelFeatures	CustomModelFeatures Características compatibles con el modelo.

DetailedErrorCode

Enumeración

DetailedErrorCode

Valor	Description
InvalidParameterValue	Valor de parámetro no válido.
InvalidRequestBodyFormat	Formato de cuerpo de la solicitud no válido.
EmptyRequest	Solicitud vacía.
MissingInputRecords	Faltan registros de entrada.
InvalidDocument	Documento no válido.
ModelVersionIncorrect	Versión del modelo incorrecta.
InvalidDocumentBatch	Lote de documentos no válido.
UnsupportedLanguageCode	Código de lenguaje no admitido.
DataImportFailed	Error en la importación de datos.
InUseViolation	En infracción de uso.
InvalidLocale	Configuración regional no válida.
InvalidBaseModel	Modelo base no válido.
InvalidAdaptationMapping	Asignación de adaptación no válida.
InvalidDataset	Conjunto de datos no válido.
InvalidTest	Prueba no válida.
FailedDataset	Conjunto de datos con errores.
InvalidModel	Modelo no válido.
InvalidTranscription	Transcripción no válida.
InvalidPayload	Carga no válida.
InvalidParameter	Parámetro no válido.
EndpointWithoutLogging	Punto de conexión sin registro.
InvalidPermissions	Permisos no válidos.
InvalidPrerequisite	Requisito previo no válido.
InvalidProductId	Identificador de producto no válido.
InvalidSubscription	Suscripción no válida.
InvalidProject	Proyecto no válido.
InvalidProjectKind	Tipo de proyecto no válido.
InvalidRecordingsUri	URI de grabaciones no válidos.
OnlyOneOfUrlsOrContainerOrDataset	Solo una de direcciones URL o contenedor o conjunto de datos.
ExceededNumberOfRecordingsUris	Se superó el número de uris de grabaciones.
ModelMismatch	Error de coincidencia del modelo.
ProjectGenderMismatch	No coinciden los géneros del proyecto.
ModelDeprecated	Modelo en desuso.
ModelExists	El modelo existe.
ModelNotDeployable	El modelo no se puede implementar.
EndpointNotUpdatable	Punto de conexión no actualizable.
SingleDefaultEndpoint	Punto de conexión predeterminado único.
EndpointCannotBeDefault	El punto de conexión no puede ser predeterminado.
InvalidModelUri	URI de modelo no válido.
SubscriptionNotFound	No se encontró la suscripción.
QuotaViolation	Infracción de cuota.
UnsupportedDelta	Delta no admitido.
UnsupportedFilter	Filtro no admitido.
UnsupportedPagination	Paginación no admitida.
UnsupportedDynamicConfiguration	Configuración dinámica no admitida.
UnsupportedOrderBy	Orden no admitido por.
NoUtf8WithBom	No hay utf8 con bom.
ModelDeploymentNotCompleteState	La implementación del modelo no está completa.
SkuLimitsExist	Existen límites de SKU.
DeployingFailedModel	Se ha producido un error en la implementación del modelo.
UnsupportedTimeRange	Intervalo de tiempo no admitido.
InvalidLogDate	Fecha de registro no válida.
InvalidLogId	Identificador de registro no válido.
InvalidLogStartTime	Hora de inicio del registro no válida.
InvalidLogEndTime	Hora de finalización del registro no válida.
InvalidTopForLogs	Top no válido para los registros.
InvalidSkipTokenForLogs	Token de omisión no válido para los registros.
DeleteNotAllowed	Eliminar no permitido.
Forbidden	Prohibido.
DeployNotAllowed	No se permite la implementación.
UnexpectedError	Error inesperado.
InvalidCollection	Colección no válida.
InvalidCallbackUri	URI de devolución de llamada no válido.
InvalidSasValidityDuration	Duración de validez de sas no válida.
InaccessibleCustomerStorage	Almacenamiento de clientes inaccesible.
UnsupportedClassBasedAdaptation	Adaptación basada en clases no admitidas.
InvalidWebHookEventKind	Tipo de evento web hook no válido.
InvalidTimeToLive	Tiempo de vida no válido.
InvalidSourceAzureResourceId	Identificador de recurso de Azure de origen no válido.
ModelCopyOperationExists	Existe una operación de copia del modelo.

EntityError

Object

EntityError

Nombre	Tipo	Description
code	string	Código de este error.
message	string	Mensaje para este error.

EntityReference

Object

EntityReference

Nombre	Tipo	Description
self	string (uri)	Ubicación de la entidad a la que se hace referencia.

Error

Object

Error

Nombre	Tipo	Description
code	ErrorCode	ErrorCode Códigos de error de alto nivel.
details	Error[]	Detalles de apoyo adicionales relacionados con el error o las directivas esperadas.
innerError	InnerError	InnerError Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message	string	Mensaje de error de alto nivel.
target	string	Origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.

ErrorCode

Enumeración

ErrorCode

Valor	Description
InvalidRequest	Representa el código de error de solicitud no válido.
InvalidArgument	Representa el código de error de argumento no válido.
InternalServerError	Representa el código de error interno del servidor.
ServiceUnavailable	Representa el código de error del servicio no disponible.
NotFound	Representa el código de error no encontrado.
PipelineError	Representa el código de error de canalización.
Conflict	Representa el código de error en conflicto.
InternalCommunicationFailed	Representa el código de error de comunicación interna con error.
Forbidden	Representa el código de error prohibido.
NotAllowed	Representa el código de error no permitido.
Unauthorized	Representa el código de error no autorizado.
UnsupportedMediaType	Representa el código de error de tipo de medio no admitido.
TooManyRequests	Representa el código de error de demasiadas solicitudes.
UnprocessableEntity	Representa el código de error de entidad no procesado.

InnerError

Object

InnerError

Nombre	Tipo	Description
code	DetailedErrorCode	DetailedErrorCode Enumeración detallada del código de error.
details	object	Detalles de apoyo adicionales relacionados con el error o las directivas esperadas.
innerError	InnerError	InnerError Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message	string	Mensaje de error de alto nivel.
target	string	Origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.

OutputFormatType

Enumeración

OutputFormatType

Valor	Description
Lexical	El modelo proporciona la salida de transcripción sin formato.
Display	El modelo admite la visualización de transcripciones de formato de salida o puntos de conexión.

Status

Enumeración

Estado

Valor	Description
NotStarted	La operación de larga duración aún no se ha iniciado.
Running	La operación de larga duración se está procesando actualmente.
Succeeded	La operación de larga duración se ha completado correctamente.
Failed	Error en la operación de larga duración.

Compartir a través de

Models - Create

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Authorization

Ejemplos

Create a model

Solicitud de ejemplo

Respuesta de muestra

Create a model with custom model weight

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CustomModel

CustomModelDeprecationDates

CustomModelFeatures

CustomModelLinks

CustomModelProperties

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

OutputFormatType

Status