文档首页/ 魔坊(ModelArts)模型训推平台/ API参考/ 模型训练/ 训练管理/ 发布精调训练产物为模型资产 - PublishFtArtifacts
更新时间:2026-08-26 GMT+08:00
分享

发布精调训练产物为模型资产 - PublishFtArtifacts

功能介绍

训练任务运行成功后,将产生的模型信息发布到资产中心。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v2/{project_id}/training-jobs/{training_job_id}/ft-artifacts/publish

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:不涉及。

取值范围:1 - 64字符,字母、数字和中划线。

默认取值:不涉及。

training_job_id

String

参数解释:训练作业ID。获取方法请参见查询训练作业列表

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

workspace_id

String

工作空间ID

publish_artifacts

Array of ArtifactsPublish objects

产物发布请求列表

表3 ArtifactsPublish

参数

是否必选

参数类型

描述

is_ckpt

Boolean

是否是中间产物,false-是模型产物,true-是中间产物

artifact_id

String

断点ID,ckpt发布时使用

asset_name

String

模型产物发布后资产名称,默认{源模型名字}-{训练类型}-{训练时间}

visibility

String

全局可见性,用来控制资产是当前空间可见或者全部空间可见,取值current|all。

description

String

发布资产描述信息,{任务名}的最终产出模型

publish_asset_type

String

模型发布方式

asset_source_type

String

资产来源

asset_code

String

选择模型。

asset_version

String

版本号。

version_description

String

版本描述。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

model_id

String

模型ID

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

error_solution

String

错误解决建议。

请求示例

如下以查询uuid为3faf5c03-aaa1-4cbe-879d-24b05d997347的训练作业为例。

GET https://{endpoint}/v2/{project_id}/training-jobs/3faf5c03-aaa1-4cbe-879d-24b05d997347/ft-artifacts/publish

响应示例

状态码:200

模型ID

{
  "model_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3"
}

状态码:400

通用的错误应答消息体格式;如下为id是3f5d6706-7b67-408d-8ba0-ec08048c45ee的训练作业未找到时的返回信息。

{
  "error_msg" : "Job not found.",
  "error_code" : "ModelArts.2755",
  "error_solution" : "Check whether the training job in the request is valid."
}

状态码

状态码

描述

200

模型ID

400

通用的错误应答消息体格式;如下为id是3f5d6706-7b67-408d-8ba0-ec08048c45ee的训练作业未找到时的返回信息。

错误码

请参见错误码

相关文档