文档首页/ AI开发平台ModelArts/ API参考/ 训练管理/ 创建训练实验
更新时间：2025-07-28 GMT+08:00
查看PDF
分享

创建训练实验

功能介绍

创建训练实验。

调试

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

URI

POST /v2/{project_id}/training-experiments

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

约束限制：1 - 64字符，字母、数字和中划线。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

metadata

是

TrainingExperimentRequestMetadata object

训练实验创建参数
表3 TrainingExperimentRequestMetadata

参数

是否必选

参数类型

描述

name

是

String

实验名称，最大长度64，不支持特殊字符。

description

否

String

描述信息，最大长度256，不支持特殊字符。

workspace_id

否

String

工作空间ID，默认为0。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

metadata

TrainingExperimentResponseMetadata object

训练实验数据。

statistic

TrainingExperimentStatistic object

训练实验的统计数据。
表5 TrainingExperimentResponseMetadata

参数

参数类型

描述

name

String

实验名称，最大长度64，不支持特殊字符。

description

String

描述信息，最大长度256，不支持特殊字符。

workspace_id

String

工作空间ID，默认为0。

create_time

Integer

创建时间。

update_time

Integer

更新时间。

id

String

实验ID。
表6 TrainingExperimentStatistic

参数

参数类型

描述

job_count

Integer

当前实验下的训练作业总个数。

请求示例

创建实验。

POST https://{endpoint}/v2/{project_id}/training-experiments

{
  "metadata" : {
    "name" : "test",
    "description" : "demo",
    "workspace_id" : "0"
  }
}

响应示例

状态码：200

OK

{
  "metadata" : {
    "id" : "6ccc15e6-8a81-4d8e-8bee-53401d850639",
    "name" : "test",
    "description" : "demo",
    "create_time" : 1731552542622,
    "workspace_id" : "0",
    "update_time" : 1731552542000
  },
  "statistic" : {
    "job_count" : 0
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 训练管理

相关文档