本文主要介绍MaxCompute模型及模型版本的相关修改操作。
功能概览
类型 | 功能 | 角色 | 操作入口 |
增加模型版本 | 为已存在的MaxCompute模型新增版本。 | 具备修改模型权限（ALTER）的用户。 | 本文中的命令可以在如下工具平台执行： |
删除模型版本 | 为已存在的MaxCompute模型删除指定版本。 | ||
设置模型默认版本 | 修改已存在的MaxCompute模型的默认版本。 |
适用范围
执行模型及模型版本的修改操作前，请确保已在对应项目下创建MaxCompute模型对象，详情请参考创建与删除模型。
MaxCompute公共模型归属于MaxCompute系统账号下的公共项目，不支持用户手动修改模型版本信息。具体公共模型列表和使用方法请参考MaxCompute模型。
新增模型版本
为已存在的MaxCompute模型新增版本。
命令格式
ALTER MODEL <model_name> ADD VERSION <version_name>
[INPUT(<input_col_name> <input_data_type>, ... )]
WITH OPTIONS(
[MODEL_SOURCE_TYPE = '<model_source_type>']
[,MODEL_TYPE = '<model_type>']
[,LOCATION = '<location>']
[,ROLEARN = '<rolearn>']
[,TASKS = '<tasks>']
[,PAI_EAS_MODEL_NAME = '<pai_eas_model_name>']
[,PAI_EAS_SERVICE_NAME = '<pai_eas_service_name>']
[,ENDPOINT= '<endpoint>']
[,APIKEY = '<apikey>']
[,PAI_EAS_SYNC_MODE = 'true']
[,PAI_EAS_SYNC_REQUEST_TIMEOUT = '5000']
)
[COMMENT <model_comment>]; 参数说明
通用参数
参数 | 是否必填 | 说明 | 备注 |
model_name | 是 | 模型名称 | 指定需要修改的已有模型名称，若不存在则报错 |
version_name | 是 | 新增的模型版本名称 |
|
input_col_name | 否 | 模型版本的输入列名 |
注意：当模型来源类型为导入模型时，必填 |
input_date_type | 否 | 模型版本的输入列的数据类型 |
注意：当模型来源类型为导入模型时，必填 |
model_source_type | 否 | 模型来源类型 | 非必填，如果填写，同一个模型的各个版本model_source_type 取值需保持一致，否则会报错
|
model_type | 否 | 模型类型 | 非必填。如果填写，同一个模型的各个版本model_type 取值需保持一致，否则会报错 当模型来源为导入模型时，支持取值：
当模型来源为远程模型时，支持取值：
|
comment | 否 | 新增模型版本的注释信息 | 注释内容为长度不超过1024字节的有效字符串，否则报错。 |
导入模型参数
参数 | 是否必填 | 说明 | 备注 |
location | 是 | 模型文件的OSS路径 | 指定要导入的模型文件在OSS对象存储的路径信息。仅支持OSS内网地址，例如 |
rolearn | 是 | OSS访问认证角色 | 指定访问存储模型文件的OSS路径的RAM角色认证信息，例如 使用前，请确保已将OSS的数据相关权限赋予MaxCompute的访问账号。
|
远程模型参数
参数 | 是否必填 | 说明 | 备注 |
tasks | 是 | 任务类型 | 支持取值如下：
|
pai_eas_model_name | 是 | PAI EAS部署的模型名称 | 可通过PAI EAS控制台，查看已部署模型及服务名称，并在调用信息页面获取对应方位地址和Token信息 |
pai_eas_service_name | 是 | PAI EAS模型服务名称 | |
endpoint | 是 | PAI EAS 服务的访问地址 | |
apikey | 是 | PAI EAS 服务Token | |
pai_eas_sync_mode | 是 | 控制服务处理请求的模式 | 仅支持true，表示同步模式 |
pai_eas_sync_request_timeout | 否 | 同步请求的超时时间 | 单位为毫秒，默认值为5000，范围5000-1800000。 |
使用示例
示例1：为已创建的远程模型PAI_EAS_Qwen25_Omni_3B增加v2版本，指定模型可接受的INPUT输入参数（STRING类型图片URL），用于执行图生文任务，完整示例请参考使用MaxCompute远程模型自动生成电商选品描述。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B ADD VERSION v2
INPUT(url STRING, promt STRING)
WITH OPTIONS(
TASKS = 'text-generation',
PAI_EAS_MODEL_NAME = 'Qwen2.5-Omni-3B',
PAI_EAS_SERVICE_NAME = 'test_remote_model',
ENDPOINT = 'http://11261230********.cn-shanghai.pai-eas.aliyuncs.com/api/predict/test_remote_model',
APIKEY = '<apikey>',
PAI_EAS_SYNC_MODE = 'true'
)
COMMENT "PAI EAS remote model string-url input";示例2：为已创建的test_xgboost_classifier模型增加v2版本。
ALTER MODEL test_xgboost_classifier ADD VERSION V2
INPUT (f1 int,f2 int,f3 int)
WITH OPTIONS(
LOCATION = 'oss://oss-cn-shanghai.aliyuncs.com/model-bucket-test/xgboost_classifier_v2/',
ROLEARN = 'acs:ram::11261230********:role/aliyunodpsdefaultrole'
)
COMMENT 'Import XGBoost model v2';设置模型默认版本
重新设置已存在的MaxCompute模型的默认版本。
命令格式
ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>;参数说明
model_name：必填。指定已有的模型名称，若不存在则报错。
version_name：必填。指定已有模型版本名称，将其设置为模型的默认版本(DEFAULT_VERSION)，若不存在则报错。
使用示例
-- 查看模型的默认版本信息，此时模型的默认版本为v1，支持的输入参数列为Binary类型。
DESC MODEL PAI_EAS_Qwen25_Omni_3B;
+------------------------------------------------------------------------------------+
| Model Information |
+------------------------------------------------------------------------------------+
| Owner: ALIYUN$********* |
| Project: ****_demo |
| Model Name: pai_eas_qwen25_omni_3b |
| Model Type: MLLM |
| Source Type: REMOTE |
| Default Version: v1 |
| CreateTime: 2025-10-09 18:32:48 |
| LastModifiedTime: 2025-10-10 16:38:41 |
| Comment: PAI EAS remote model binary input |
+------------------------------------------------------------------------------------+
| Version Information |
+------------------------------------------------------------------------------------+
| Owner: ALIYUN$********* |
| Project: ****_demo |
| Model Name: pai_eas_qwen25_omni_3b |
| Model Type: MLLM |
| Source Type: REMOTE |
| Version Name: v1 |
| Path: |
| CreateTime: 2025-10-09 18:32:48 |
| LastModifiedTime: 2025-10-09 18:32:48 |
| APIKEY: ZjA5NGRjN2VjOTZiM********TZmZTQ1MThkMGE4ZmUyNj********== |
| ENDPOINT: http://11261230********.cn-shanghai.pai-eas.aliyuncs.com/api/predict/test_remote_model |
| PAI_EAS_MODEL_NAME: Qwen2.5-Omni-3B |
| PAI_EAS_SERVICE_NAME: test_remote_model |
| PAI_EAS_SYNC_MODE: true |
| REMOTE_SERVICE_TYPE: PAI-EAS |
+------------------------------------------------------------------------------------+
| Input | Type | Comment |
+------------------------------------------------------------------------------------+
| data | binary | |
| promt | string | |
+------------------------------------------------------------------------------------+
OK
-- 修改模型的默认版本为v2。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v2;
-- 查看模型的默认版本信息，此时模型的默认版本变更为v2，支持的输入参数列为STRING类型
DESC MODEL PAI_EAS_Qwen25_Omni_3B;
+------------------------------------------------------------------------------------+
| Model Information |
+------------------------------------------------------------------------------------+
| Owner: ALIYUN$********* |
| Project: muze_demo |
| Model Name: pai_eas_qwen25_omni_3b |
| Model Type: MLLM |
| Source Type: REMOTE |
| Default Version: v2 |
| CreateTime: 2025-10-09 18:32:48 |
| LastModifiedTime: 2025-10-10 16:55:07 |
| Comment: PAI EAS remote model binary input |
+------------------------------------------------------------------------------------+
| Version Information |
+------------------------------------------------------------------------------------+
| Owner: ALIYUN$********* |
| Project: *******_demo |
| Model Name: pai_eas_qwen25_omni_3b |
| Model Type: MLLM |
| Source Type: REMOTE |
| Version Name: v2 |
| Path: |
| CreateTime: 2025-10-10 16:53:51 |
| LastModifiedTime: 2025-10-10 16:53:51 |
| apikey: ZjA5NGRjN2Vj*********mU0OTZmZTQ1MTh***********jBhMmEzYw== |
| endpoint: http://11261230********.cn-shanghai.pai-eas.aliyuncs.com/api/predict/test_remote_model |
| pai_eas_model_name: Qwen2.5-Omni-3B |
| pai_eas_service_name: test_remote_model |
| pai_eas_sync_mode: true |
| remote_service_type: PAI-EAS |
+------------------------------------------------------------------------------------+
| Input | Type | Comment |
+------------------------------------------------------------------------------------+
| url | string | |
| promt | string | |
+------------------------------------------------------------------------------------+
删除模型版本
删除已存在的MaxCompute模型的指定版本。
不支持删除模型的默认版本，如需删除请先修改模型的默认版本。
命令格式
ALTER MODEL <model_name> DROP VERSION <version_name>;参数说明
model_name：必填。指定已有的模型名称，若不存在则报错。
version_name：必填。指定待删除的模型版本名称，若不存在则报错。
使用示例
-- 若当前模型默认版本为v2，删除该版本会报错。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- 返回FAILED: ODPS-0110061: Failed to run ddltask - The default version of the model cannot be dropped
-- 正确示例，先变更当前模型默认版本为v1，再删除v2版本。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v1;
-- OK
ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- OK