调用CreateTrainingJob接口创建训练任务-人工智能平台 PAI-阿里云

创建训练任务。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

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	long	否	Ecs 实例数。	1
EcsSpec	string	否	Ecs 型号。	ecs.gn5-c8g1.2xlarge
ResourceId	string	否	资源配额（Quota）ID。	quotam670lixikcs
InstanceCount	long	否	资源配额使用实例数。	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：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。	SpotWithPriceLimit
SpotDiscountLimit	float	否	设置实例的每小时最高价格折扣，参数 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
InputUri	string	否	输入数据链接。	oss://pai-quickstart-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/modelscope/models/qwen2-0.5b/main/
Options	string	否	输入数据参数配置。	{"appendable": true}
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/
Scheduler	object	否	训练任务调度配置。
MaxRunningTimeInSeconds	long	否	最大训练运行时长，单位为秒。数值为 0 时不限制最大运行时常。	0
MaxRunningTimeInMinutes	long	否	最大训练运行时长，单位为分钟。数值为 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

返回参数

名称	类型	描述	示例值
	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"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2025-11-25	API 内部配置变更，不影响调用	查看变更详情
2024-11-18	API 内部配置变更，不影响调用	查看变更详情
2024-09-23	API 内部配置变更，不影响调用	查看变更详情
2024-07-03	API 内部配置变更，不影响调用	查看变更详情
2024-05-09	API 内部配置变更，不影响调用	查看变更详情
2024-02-29	API 内部配置变更，不影响调用	查看变更详情
2023-12-26	API 内部配置变更，不影响调用	查看变更详情
2023-12-15	API 内部配置变更，不影响调用	查看变更详情
2023-09-12	API 内部配置变更，不影响调用	查看变更详情
2023-09-01	API 内部配置变更，不影响调用	查看变更详情
2023-08-22	API 内部配置变更，不影响调用	查看变更详情
2023-05-24	API 内部配置变更，不影响调用	查看变更详情
2023-04-20	API 内部配置变更，不影响调用	查看变更详情