Create a training job.
Try it now
Test
RAM authorization
Request syntax
POST /api/v1/trainingjobs HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
Request body parameters. |
|
| AlgorithmName |
string |
No |
Algorithm name. |
ev_classification |
| AlgorithmProvider |
string |
No |
Algorithm provider. |
pai |
| AlgorithmVersion |
string |
No |
Algorithm version. |
v1.0.0 |
| ComputeResource |
object |
No |
Compute resource configuration. |
|
| EcsCount |
integer |
No |
Number of ECS instances. |
1 |
| EcsSpec |
string |
No |
ECS instance type. |
ecs.gn5-c8g1.2xlarge |
| ResourceId |
string |
No |
Resource quota ID. |
quotam670lixikcs |
| InstanceCount |
integer |
No |
Number of instances used by the resource quota. |
1 |
| InstanceSpec |
object |
No |
Resource quota instance configuration. |
|
| CPU |
string |
No |
Number of CPU cores for the instance. |
8 |
| Memory |
string |
No |
Instance memory size, in GiB. |
32 |
| SharedMemory |
string |
No |
Instance shared memory size, in GB. |
32 |
| GPU |
string |
No |
Number of GPU cards for the instance. |
1 |
| GPUType |
string |
No |
GPU card type for the instance. |
V100 |
| SpotSpec |
object |
No |
Spot instance configuration. |
|
| SpotStrategy |
string |
No |
SpotStrategy: The preemption policy for the instance. Valid values:
|
SpotWithPriceLimit |
| SpotDiscountLimit |
number |
No |
Set the maximum hourly price discount for the instance. This parameter takes effect when SpotStrategy is set to SpotWithPriceLimit. |
9 |
| UseSpotInstance |
boolean |
No |
Specifies whether to use a spot instance. |
true |
| HyperParameters |
array<object> |
No |
Training hyperparameters configuration. |
|
|
object |
No |
Training hyperparameters configuration. |
||
| Name |
string |
No |
Parameter name. |
learning_rate |
| Value |
string |
No |
Parameter value. |
0.0001 |
| InputChannels |
array<object> |
No |
Training input data configuration. |
|
|
object |
No |
Training input data configuration. |
||
| Name |
string |
No |
Input data name. |
model |
| DatasetId |
string |
No |
Dataset ID. |
d-475megosidivjfgfq6 |
| VersionName |
string |
No |
||
| InputUri |
string |
No |
Input data link. |
oss://pai-quickstart-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/modelscope/models/qwen2-0.5b/main/ |
| Options |
string |
No |
Input data parameter configuration. |
{"appendable": true} |
| Labels |
array<object> |
No |
Training job labels. |
|
|
object |
No |
Training job labels. |
||
| Key |
string |
No |
Label key. |
CreatedBy |
| Value |
string |
No |
Label value. |
QuickStart |
| OutputChannels |
array<object> |
No |
Training output data configuration. |
|
|
object |
No |
Training output data configuration. |
||
| DatasetId |
string |
No |
Dataset ID. |
d-475megosidivjfgfq6 |
| Name |
string |
No |
Output data name. |
model |
| OutputUri |
string |
No |
Output data configuration. |
oss://pai-quickstart-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/modelscope/models/qwen2-0.5b/main/ |
| VersionName |
string |
No |
||
| Scheduler |
object |
No |
Training job scheduling configuration. |
|
| MaxRunningTimeInSeconds |
integer |
No |
Maximum training runtime, in seconds. A value of 0 means no limit on the maximum runtime. |
0 |
| MaxRunningTimeInMinutes |
integer |
No |
Maximum training runtime, in minutes. A value of 0 means no limit on the maximum runtime. |
0 |
| TrainingJobDescription |
string |
No |
Training job description. |
qwen large language model training |
| TrainingJobName |
string |
Yes |
Training job name. |
qwen_llm |
| WorkspaceId |
string |
Yes |
Workspace ID. |
12345 |
| AlgorithmSpec | AlgorithmSpec |
No |
Training job algorithm configuration. |
|
| CodeDir | Location |
No |
Training job code configuration. |
|
| RoleArn |
string |
No |
Specify the ARN of the role. Format: acs:ram::$accountID:role/$roleName. |
acs:ram::1157703270994901:role/aliyunserviceroleforpaiworkspace |
| UserVpc |
object |
No |
VPC configuration. |
|
| VpcId |
string |
No |
VPC ID. |
vpc-dxiflssjx978sl |
| SwitchId |
string |
No |
vSwitch ID. |
vs-icrc813vdsfol |
| SecurityGroupId |
string |
No |
Security group ID. |
sg-qdfasd13sdasf |
| ExtendedCIDRs |
array |
No |
Extended CIDR block configuration. |
|
|
string |
No |
Extended CIDR block configuration. |
192.168.0.1/24 |
|
| DefaultRoute |
string |
No |
Default routing interface. `eth0` means the default route uses the PAI VPC. `eth1` means the default route uses the user VPC. The default is `eth0`. |
eth0 |
| Settings | JobSettings |
No |
Additional training job parameter settings. |
|
| ExperimentConfig |
object |
No |
Training job experiment association configuration. |
|
| ExperimentId |
string |
No |
Training job experiment ID. |
exp-ds9aefia90v |
| Environments |
object |
No |
Training job environment variables. |
|
|
string |
No |
Training job environment variables. |
debug=true |
|
| PythonRequirements |
array |
No |
Training job Python package configuration. |
|
|
string |
No |
Training job Python package configuration. |
numpy |
|
| Priority |
integer |
No |
Training job priority. |
1 |
| AssignNodeSpec |
AssignNodeSpec |
No |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| TrainingJobId |
string |
Training job ID. |
traineyfz0m2hsfv |
| RequestId |
string |
Request ID. |
E7C42CC7-2E85-508A-84F4-923B605FD10F |
Examples
Success response
JSON format
{
"TrainingJobId": "traineyfz0m2hsfv",
"RequestId": "E7C42CC7-2E85-508A-84F4-923B605FD10F"
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.