CreateModelService - Hologres - Centro de documentación de Alibaba Cloud

Crea un servicio de modelo que permite a las funciones de IA invocar modelos. Puede crear un servicio para dos tipos de modelos: un modelo de Alibaba Cloud Model Studio o un modelo en un nodo de IA de Hologres. Si utiliza un nodo de IA de Hologres, debe adquirir los recursos del nodo de IA por separado.

Descripción de la operación

Para crear un servicio de modelo, debe especificar varios parámetros. Utilice la operación ListModelCatalog para buscar los parámetros de un modelo de Alibaba Cloud Model Studio, y utilice la operación GetAvailableModelsResource para un modelo en un nodo de IA de Hologres.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

POST /api/v1/instances/{instanceId}/createModelService HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
instanceId	string	Sí	El ID de la instancia.	hgpostcn-cn-lbj335xxxx

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
body	object	No	El cuerpo de la solicitud.
modelType	string	Sí	El nombre del modelo. Para buscar el nombre, llame a `ListModelCatalog` para un modelo de Alibaba Cloud Model Studio, o a `GetAvailableModelsResource` para un modelo en un nodo de IA de Hologres.	qwen3.5-plus
cpu	integer	No	El número de vCPU. Este parámetro es obligatorio solo para un nodo de IA de Hologres.	16
memory	integer	No	El tamaño de memoria en GB. Este parámetro es obligatorio solo para un nodo de IA de Hologres.	64
gpu	integer	No	El número de GPU. Este parámetro es obligatorio solo para un nodo de IA de Hologres.	1
serviceCount	integer	No	El número de réplicas. Este parámetro es obligatorio solo para un nodo de IA de Hologres.	2
modelServiceName	string	Sí	Un nombre personalizado para el servicio de modelo.	my_model
gpuMemory	integer	No	El tamaño de memoria de GPU en GB. Este parámetro es obligatorio solo para un nodo de IA de Hologres.	64
taskType	string	No	El tipo de tarea que realiza el modelo, como `chat/completions` o `embedding`. Para consultar los tipos de tarea admitidos, revise la salida de la operación `ListModelCatalog`.	embedding
provider	string	No	El proveedor del modelo subyacente. Valores válidos: hologres : Hologres. bailian : Alibaba Cloud Model Studio.	bailian
apiKey	string	No	La clave de API para Alibaba Cloud Model Studio. Este parámetro es obligatorio solo para modelos de Model Studio. Puede obtener esta clave desde la consola de Model Studio o mediante una llamada a la API.	api-key-xxx
modelParams	string	No	Los parámetros del modelo, obligatorios solo para modelos de Model Studio. Puede proporcionar los parámetros predeterminados devueltos por la operación `ListModelCatalog` o una versión modificada de estos.	{"timeout":600,"max_retries":10,"max_retry_delay":8,"initial_retry_delay":0.5}

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de la respuesta.
requestId	string	El ID de la solicitud.	819A7F0F-2951-540F-BD94-6A41ECF0281F
data	boolean	Indica si la operación se realizó correctamente. Un valor de `true` indica éxito y `false` indica fallo.	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F",
  "data": true
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.