创建训练任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/trainingjobs HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 body 参数。 |
|
| AlgorithmName |
string |
否 |
算法名称。 |
ev_classification |
| AlgorithmProvider |
string |
否 |
算法提供方。 |
pai |
| AlgorithmVersion |
string |
否 |
算法版本。 |
v1.0.0 |
| ComputeResource |
object |
否 |
计算资源配置。 |
|
| EcsCount |
integer |
否 |
Ecs 实例数。 |
1 |
| EcsSpec |
string |
否 |
Ecs 型号。 |
ecs.gn5-c8g1.2xlarge |
| ResourceId |
string |
否 |
资源配额（Quota）ID。 |
quotam670lixikcs |
| InstanceCount |
integer |
否 |
资源配额使用实例数。 |
1 |
| InstanceSpec |
object |
否 |
资源配额实例配置。 |
|
| CPU |
string |
否 |
实例 CPU 核数。 |
8 |
| Memory |
string |
否 |
实例内存大小，单位为 GiB。 |
32 |
| SharedMemory |
string |
否 |
实例共享内存大小，单位 GB。 |
32 |
| GPU |
string |
否 |
实例 GPU 显卡数量。 |
1 |
| GPUType |
string |
否 |
实例 GPU 显卡型号。 |
V100 |
| SpotSpec |
object |
否 |
抢占式实例配置。 |
|
| SpotStrategy |
string |
否 |
SpotStrategy: 实例的抢占策略，取值范围：
|
SpotWithPriceLimit |
| SpotDiscountLimit |
number |
否 |
设置实例的每小时最高价格折扣，参数 SpotStrategy 取值为 SpotWithPriceLimit 时生效。 |
9 |
| UseSpotInstance |
boolean |
否 |
是否使用抢占式实例。 |
true |
| HyperParameters |
array<object> |
否 |
训练超参数配置。 |
|
|
object |
否 |
训练超参数配置。 |
||
| Name |
string |
否 |
参数名。 |
learning_rate |
| Value |
string |
否 |
参数值。 |
0.0001 |
| InputChannels |
array<object> |
否 |
训练输入数据配置。 |
|
|
object |
否 |
训练输入数据配置。 |
||
| Name |
string |
否 |
输入数据名称。 |
model |
| DatasetId |
string |
否 |
数据集 ID。 |
d-475megosidivjfgfq6 |
| VersionName |
string |
否 |
||
| InputUri |
string |
否 |
输入数据链接。 |
oss://pai-quickstart-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/modelscope/models/qwen2-0.5b/main/ |
| Options |
string |
否 |
输入数据参数配置。 |
{"appendable": true} |
| RoleArn |
string |
否 |
||
| Labels |
array<object> |
否 |
训练任务标签。 |
|
|
object |
否 |
训练任务标签。 |
||
| Key |
string |
否 |
标签的键。 |
CreatedBy |
| Value |
string |
否 |
标签的值。 |
QuickStart |
| OutputChannels |
array<object> |
否 |
训练输出数据配置。 |
|
|
object |
否 |
训练输出数据配置。 |
||
| DatasetId |
string |
否 |
数据集 ID。 |
d-475megosidivjfgfq6 |
| Name |
string |
否 |
输出数据名称。 |
model |
| OutputUri |
string |
否 |
输出数据配置。 |
oss://pai-quickstart-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/modelscope/models/qwen2-0.5b/main/ |
| VersionName |
string |
否 |
||
| RoleArn |
string |
否 |
||
| Scheduler |
object |
否 |
训练任务调度配置。 |
|
| MaxRunningTimeInSeconds |
integer |
否 |
最大训练运行时长，单位为秒。数值为 0 时不限制最大运行时常。 |
0 |
| MaxRunningTimeInMinutes |
integer |
否 |
最大训练运行时长，单位为分钟。数值为 0 时不限制最大运行时常。 |
0 |
| TrainingJobDescription |
string |
否 |
训练任务描述。 |
qwen large language model training |
| TrainingJobName |
string |
是 |
训练任务名称。 |
qwen_llm |
| WorkspaceId |
string |
是 |
工作空间 ID。 |
12345 |
| AlgorithmSpec | AlgorithmSpec |
否 |
训练任务算法配置。 |
|
| CodeDir | Location |
否 |
训练任务代码配置。 |
|
| RoleArn |
string |
否 |
指定角色的 ARN。格式：acs:ram::$accountID:role/$roleName。 |
acs:ram::1157703270994901:role/aliyunserviceroleforpaiworkspace |
| UserVpc |
object |
否 |
VPC 配置。 |
|
| VpcId |
string |
否 |
VPC ID。 |
vpc-dxiflssjx978sl |
| SwitchId |
string |
否 |
交换机 ID。 |
vs-icrc813vdsfol |
| SecurityGroupId |
string |
否 |
安全组 ID。 |
sg-qdfasd13sdasf |
| ExtendedCIDRs |
array |
否 |
扩展网段配置。 |
|
|
string |
否 |
扩展网段配置。 |
192.168.0.1/24 |
|
| DefaultRoute |
string |
否 |
默认路由接口，eth0 表示默认路由走 pai 的 vpc，eht1 表示默认路由走用户 vpc，默认为 eth0。 |
eth0 |
| Settings | JobSettings |
否 |
训练任务额外参数配置。 |
|
| ExperimentConfig |
object |
否 |
训练任务关联实验配置。 |
|
| ExperimentId |
string |
否 |
训练任务关联实验 ID。 |
exp-ds9aefia90v |
| Environments |
object |
否 |
训练任务环境变量。 |
|
|
string |
否 |
训练任务环境变量。 |
debug=true |
|
| PythonRequirements |
array |
否 |
训练任务 Python 包配置。 |
|
|
string |
否 |
训练任务 Python 包配置。 |
numpy |
|
| Priority |
integer |
否 |
训练任务优先级 |
1 |
| AssignNodeSpec |
AssignNodeSpec |
否 |
||
| CredentialConfig |
CredentialConfig |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| TrainingJobId |
string |
训练任务 ID。 |
traineyfz0m2hsfv |
| RequestId |
string |
请求 ID。 |
E7C42CC7-2E85-508A-84F4-923B605FD10F |
示例
正常返回示例
JSON格式
{
"TrainingJobId": "traineyfz0m2hsfv",
"RequestId": "E7C42CC7-2E85-508A-84F4-923B605FD10F"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。