更新时间：2026-09-10 GMT+08:00

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

功能介绍

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

调试

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

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
modelarts:trainJob:publishFtArtifacts	Write	trainJob *	g:EnterpriseProjectId	-	-

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的训练作业为例。

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

{
  "workspace_id" : "8f0xxxxx7",
  "publish_artifacts" : [ {
    "is_ckpt" : false,
    "asset_name" : "Pangu-NLP-N2-32K-SFT-20250401220401",
    "visibility" : "current",
    "description" : "N1模型微调的最终产出模型",
    "publish_asset_type" : "NEW_ASSET",
    "asset_source_type" : "custom_train",
    "asset_code" : "pangu-nlp-n2-32k",
    "asset_version" : "v1",
    "version_description" : "首次发布的精调模型版本"
  } ]
}

响应示例

状态码：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的训练作业未找到时的返回信息。

错误码

请参见错误码。

父主题： 训练管理