-
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，
获取Token 接口响应消息头中X-Subject-Token的值即为Token。 约束限制： 不涉及 取值范围： 长度为[1-32768]个字符。 默认取值： 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 参数解释： 模型名称。 约束限制： 不涉及 取值范围： 长度范围[5-32]个字符，允许大小写字母、数字、下划线(_)、中划线(-)和空格，只能以字母开头。 默认取值： 不涉及 description 否 String 参数解释： 模型描述信息。 约束限制： 不涉及 取值范围： 长度范围[0-1024]个字符。 默认取值： 不涉及 type 是 String 参数解释： 模型类型。 约束限制： 不涉及 取值范围： binary：二分型 numerical：回归型 默认取值： 不涉及 file 是 ModelFile object 参数解释： 模型数据来源。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 shareable 否 Boolean 参数解释： 是否打开组织共享。 约束限制： 不涉及 取值范围： true：组织共享。 false：组织不共享。 默认取值： false base_model_id 否 String 参数解释： 基模型ID。 约束限制： 不涉及 取值范围： 长度范围[1-128]，只能包含字母、数字、下划线和中划线。目前仅支持pangu-drug-model或租户专属基模型。 默认取值： pangu-drug-model 表4 ModelFile 参数 是否必选 参数类型 描述 source 是 String 参数解释： 模型数据文件来源。 约束限制： 当数据源source为用户私有数据中心时为空间路径，为公共数据场景时为obs地址。 取值范围： public：公共数据 private：私有数据 默认取值： 不涉及 url 是 String 参数解释： 文件URL。 约束限制： 当数据源source为用户私有数据中心时为空间路径，为公共数据场景时为obs地址。 取值范围： 文件URL仅支持以.csv结尾。 默认取值： 不涉及 eihealth_project_id 否 String 参数解释： 模型文件所在空间ID，您可以从获取空间ID中获取。 约束限制： 仅文件为数据中心时填写。 取值范围： 长度范围[1-128]个字符，只能包含字母、数字、下划线和连字符。 默认取值： 不涉及
-
响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 assistant_models Array of AssistantModel objects 参数解释： 供应商模型列表。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 count Integer 参数解释： 供应商模型个数。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 表5 AssistantModel 参数 参数类型 描述 id String 参数解释： 模型供应商ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 service_name String 参数解释： 服务名称。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 name String 参数解释： 模型名称。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 type String 参数解释： 模型类型。 约束限制： 不涉及 取值范围： CHAT：文本对话模型 EMBEDDING：嵌入模型 默认取值： 不涉及 model_service_api String 参数解释： 模型服务API地址。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 function_call Boolean 参数解释： 是否支持工具调用。 约束限制： 不涉及 取值范围： true：支持工具调用 false：不支持工具调用 默认取值： 不涉及 chain_of_thought Boolean 参数解释： 是否支持思维链。 约束限制： 不涉及 取值范围： true：支持思维链 false：不支持思维链 默认取值： 不涉及 creator String 参数解释： 模型创建人。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 creator_id String 参数解释： 模型创建人ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 create_time String 参数解释： 模型创建时间。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 update_time String 参数解释： 模型修改时间。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 description String 参数解释： 模型描述。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及
-
响应示例 状态码：200 OK {
"count" : 1,
"assistant_models" : [ {
"name" : "deepseek-chat",
"id" : "5e9b7c3f-d4a6-4b3c-a1b2-cdef12345678",
"service_name" : "deepseek",
"type" : "CHAT",
"model_service_api" : "https://appstage.cloud.com/v1/xxx",
"function_call" : false,
"chain_of_thought" : true,
"create_time" : "2025-01-28T02:34:36Z",
"update_time" : "2025-01-30T02:34:36Z",
"creator" : "creator",
"creator_id" : "d4a6-4b3c-a1b2-cdef1234567-85e9b7c3f"
} ]
}
-
请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 约束限制： 不涉及 取值范围： 长度为[1-32768]个字符。 默认取值： 不涉及
-
URI GET /v1/{project_id}/model-vendors/{vendor_id}/models 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 项目ID，您可以从获取项目ID中获取。 约束限制： 不涉及 取值范围： 仅支持字母、数字、中划线和下划线，长度为[1-128]个字符。 默认取值： 不涉及 vendor_id 是 String 参数解释： 模型供应商ID。 约束限制： 不涉及 取值范围： 仅支持字母、数字、中划线和下划线，长度为[1-128]个字符。 默认取值： 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 sort_key 否 String 参数解释： 排序规则，目前默认创建时间降序。 约束限制： 不涉及 取值范围： service_name：服务名称 name：模型名称 type：模型类型 update_time：修改时间 默认取值： update_time sort_dir 否 String 参数解释： 排序方向。 约束限制： 不涉及 取值范围： acs：升序 desc：降序 默认取值： desc
-
响应参数 状态码：200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. 表5 响应Body参数 参数 参数类型 描述 id String 事件模型ID name String 事件模型名称，租户下唯一 description String 事件模型描述 compatibility String 事件模型兼容性 provider_type String 提供方类型，OFFICIAL：官方事件源；CUSTOM：自定义事件源 format String 事件模型格式 number_of_versions Integer 事件模型版本数 created_time String 创建时间 updated_time String 更新时间 version Integer 事件模型当前版本号 definition String 事件模型内容定义
-
响应示例 状态码：200 Demo Information {
"id" : "2a0ee4f2-78a4-4122-80af-7455e37f64ee",
"name" : "file.upload",
"description" : "文件上传事件模型定义",
"compatibility" : "NONE",
"provider_type" : "CUSTOM",
"format" : "OPENAPI_3_0",
"number_of_versions" : 1,
"created_time" : "2021-12-09 09:00:00",
"updated_time" : "2021-12-09 09:00:00",
"version" : 1,
"definition" : "{\"$schema\": \"http://json-schema.org/draft-06/schema#\",\"title\": \"fileUpload\",\"definitions\": {\"fileUpload\": {\"properties\": {\"fileName\": {\"type\": \"string\"},\"fileSize\": {\"type\": \"integer\"}},\"required\": [\"foo\",\"bar\"],\"type\": \"object\"}},\"properties\": {\"specversion\": {\"type\": \"string\"},\"id\": {\"type\": \"string\"},\"type\": {\"type\": \"string\"},\"source\": {\"type\": \"string\"},\"subject\": {\"type\": \"string\"},\"datacontenttype\": {\"type\": \"string\"},\"dataschema\": {\"type\": \"string\"},\"time\": {\"format\": \"date-time\",\"type\": \"string\"},\"data\": {\"$ref\": \"#/definitions/fileUpload\"}},\"required\": [\"id\",\"source\",\"time\",\"type\",\"specversion\"],\"type\": \"object\"}"
}
-
请求示例 创建自定义事件模型 POST https://{endpoint}/v1/{project_id}/schemas
{
"name" : "file.upload",
"description" : "文件上传事件模型定义",
"compatibility" : "NONE",
"format" : "OPENAPI_3_0",
"definition" : "{\"$schema\": \"http://json-schema.org/draft-06/schema#\",\"title\": \"fileUpload\",\"definitions\": {\"fileUpload\": {\"properties\": {\"fileName\": {\"type\": \"string\"},\"fileSize\": {\"type\": \"integer\"}},\"required\": [\"foo\",\"bar\"],\"type\": \"object\"}},\"properties\": {\"specversion\": {\"type\": \"string\"},\"id\": {\"type\": \"string\"},\"type\": {\"type\": \"string\"},\"source\": {\"type\": \"string\"},\"subject\": {\"type\": \"string\"},\"datacontenttype\": {\"type\": \"string\"},\"dataschema\": {\"type\": \"string\"},\"time\": {\"format\": \"date-time\",\"type\": \"string\"},\"data\": {\"$ref\": \"#/definitions/fileUpload\"}},\"required\": [\"id\",\"source\",\"time\",\"type\",\"specversion\"],\"type\": \"object\"}"
}
-
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用
IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 事件模型名称，租户下唯一，由字母、数字、点、下划线和中划线组成，必须字母或数字开头 description 否 String 事件模型描述 compatibility 是 String 事件模型兼容性 format 否 String schema内容格式 definition 是 String 事件模型内容定义
-
常见问题 创建模型时，报错“Modelarts.6206:Key fields describing the model structure are missing from config.json, or their values are inconsistent with standard open source”如何处理？ 您可以按照以下步骤进行排查： 查看config.json文件是否存在。 查看config.json文件格式是否符合要求。关于格式要求，请参见Hugging Face官网。
-
为什么要创建我的模型 MaaS模型广场提供了丰富的基础模型，您可以直接使用这些模型进行在线体验、部署模型服务等操作。当基础模型无法满足个性化需求时，您可以基于模型广场的模型创建专属的个性化模型，以实现更优的效果，同时便于版本管理和持续优化。 满足个性化需求：MaaS支持结合自定义权重文件，基于昇腾云适配的开源模型创建个人专属模型。模型广场预置模型是通用的，难以契合所有用户的特定需求，如企业需要将大模型应用于特定业务场景，预置模型因缺乏针对性难以满足需求，自定义模型可以凭借定制化权重文件实现个性化功能。 实现更好的效果：在某些复杂场景中，模型广场预置模型的表现可能不尽人意。例如在专业领域的对话问答、代码生成等场景，通过创建个人模型并修改权重配置，能优化模型运行效果，在专业任务处理上比预置模型更具优势。 便于版本管理和优化：MaaS提供模型版本管理功能，一个模型最多可支持创建10个版本。创建个人模型后，您可以通过新增版本不断优化模型，提升可追溯性。
-
步骤五：查看我的模型详情 模型创建完成后，您可以在“模型详情”页面查看模型的基本信息和版本信息。 在“我的模型”页面，单击目标模型名称，进入模型详情页面，查看模型的“基本信息”和“我的版本”。 图1 模型详情 基本信息：可以查看模型名称、模型ID、模型类型、来源模型、创建时间等信息。 我的版本：可以查看已创建的模型版本，单击版本号进入“版本详情”页面，可以查看各个模型版本的详细信息和任务记录。 图2 版本详情 版本信息：可以查看模型名称、状态、创建时间、基本模型及版本、权重与词表路径等信息。 任务记录：可以查看任务名称、作业类型、状态、创建时间等信息。
-
（可选）步骤七：删除我的模型 当不需要模型时，可以进行删除操作。删除操作无法恢复，请谨慎操作。 在ModelArts Studio（MaaS）控制台左侧导航栏，选择“我的模型”进入模型列表。 在模型列表，单击目标模型名称，进入“模型详情”页面。 在“我的版本”区域，单击版本号，进入“版本详情”页面。查看该版本的模型“任务记录”是否为空。 是，表示模型未被用于训练和推理任务，可以直接删除。则直接执行下一步。 否，表示模型已被用于训练和推理任务，需要先删除所有任务，再执行下一步。 删除任务：单击操作列的“删除”，在“删除作业”对话框，输入“DELETE”，单击“确定”。 确认该模型的各个版本的“任务记录”都为空。 当模型存在任务记录会删除失败。 在“模型详情”页面，单击右上角的“删除”，在弹窗中输入“DELETE”，单击“确定”，删除模型。 当模型列表未显示该模型，表示删除成功。
-
操作场景 在当今数字化时代，人工智能应用愈发广泛。许多开发者和研究人员期望拥有个性化的大模型，用于各种特定场景，例如开发智能客服提升服务效率、辅助代码写作等。通常情况下，从头训练一个大模型需要大量的时间、计算资源和资金。多数开发者难以承担从头训练大模型的高昂成本，且技术门槛极高，涉及复杂的算法优化、海量数据处理等难题。 即使选择对开源模型进行微调，实际操作过程中仍存在阻碍，例如模型权重文件格式兼容性问题频发、本地训练的PyTorch权重文件与云平台不兼容，导致模型无法加载、不同模型的参数配置差异大等。 MaaS基于昇腾云算力适配开源大模型，推出预置模型+自定义权重的全流程方案： 极简操作，快速适配：支持直接上传Hugging Face标准格式的权重文件，平台自动完成与昇腾芯片的算力适配，无需编写额外适配代码。 模板化配置，即开即用：内置DeepSeek、通义千问、百川、ChatGLM、Llama等主流模型的配置模板，用户无需手动调整复杂参数，大幅缩短模型开发周期。 弹性算力，高效运行：提供灵活的算力资源按需分配机制，可根据模型规模和业务需求动态调整算力，为业务高效运行提供强大保障。
-
步骤四：创建我的模型 登录ModelArts Studio（MaaS）控制台，在顶部导航栏中选择目标区域。 在左侧导航栏，单击“我的模型”。 在“我的模型”页面右上角，单击“创建模型”。 在“创建模型”页面，配置相关参数。 表1 创建模型参数说明 参数 说明 来源模型 MaaS提供基于昇腾云算力适配的开源大模型供您使用。单击“选择基础模型”，在弹窗中选择模型，单击“确定”。 关于模型系列的详细介绍，请参见在ModelArts Studio（MaaS）模型广场查看预置模型。 模型名称 自定义模型名称。支持1~64位，以中文、大小写字母开头，只包含中文、大小写字母、数字、下划线（_）、中划线（-）和（.）。 描述 自定义模型简介。最大支持100字符。 权重设置与词表 默认选择“自定义权重”。权重文件指的是模型的参数集合。 自定义权重存储路径 单击“自定义权重存储路径”右侧的文件图标，选择步骤三存放模型权重文件的OBS路径（必须选择到模型文件夹），然后单击“确定”。 参数配置完成后，单击“创建”，创建自定义模型。 在模型列表，当模型“状态”变成“创建成功”时，表示模型创建完成。
