创建任务运行
更新时间:2025-08-04
注意:为提升开发者使用体验,平台升级了模型调优接口。推荐使用新版模型精调接口,功能更全面、且接口更规范,详见模型调优API列表;本文内容不再更新,由于V1版本接口后续可能下线停止服务,为避免影响使用,建议接入V2版本接口。
功能介绍
本接口用于创建训练任务运行。
使用说明
调用本文API,需使用安全认证AK/SK鉴权,调用流程及鉴权介绍详见SDK安装及使用流程。
SDK调用
调用示例
Python
1import os
2from qianfan import resources
3
4# 使用安全认证AK/SK鉴权,通过环境变量方式初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
5os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
6os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
7
8# 创建任务运行,具体参数请查看参数说明
9create_job_resp = resources.FineTune.create_job(job={
10 "taskId": task_id,
11 "baseTrainType": "***-turbo",
12 "trainType": "ERNIE-***",
13 "trainMode": "SFT",
14 "peftType": "LoRA",
15 "trainConfig": {
16 "epoch": 4,
17 "learningRate": 0.00002,
18 "batchSize": 4,
19 "maxSeqLen": 4096
20 },
21 "trainset": [
22 {
23 "type": 1,
24 "id": 1234
25 }
26 ],
27 "trainsetRate": 20
28})
29
30# 获取运行 id
31print(create_job_resp)
返回示例
Python
1QfResponse(code = 200, headers = {
2 ...
3 },
4 body = {
5 'log_id': '3019477815',
6 'result': {
7 'id': 6301
8 }
9 },
10)
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
job | dict | 是 | 任务描述 |
job说明
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
taskId | int | 是 | 任务ID |
description | string | 否 | 运行描述 |
jobRunType | int | 是 | 任务运行类型,可选值如下: · 0:普通训练 · 1:增量训练 |
increConfig | dict | 否 | 增量训练基础任务信息 |
baseTrainType | string | 否 | 基础算法类型 |
trainType | string | 否 | 具体算法类型版本 |
trainMode | string | 是 | 训练方法,说明: (1)当jobRunType为0,此字段必填 (2)固定值:SFT |
peftType | string | 否 | parameter efficient finetuning方式,peftType可选值如下: · ALL · P-tuning · LoRA |
trainConfig | dict | 是 | 训练配置 |
trainset | list | 是 | 数据集配置 |
trainsetRate | float | 是 | 数据拆分比例,取值范围:[0,50] |
increConfig说明
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
taskId | int | 是 | 基础任务ID |
jobId | int | 是 | 基础任务运行ID |
trainConfig说明
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
epoch | int | 是 | 迭代轮次,取值范围:[1, 50] |
batchSize | int | 否 | 批处理大小 |
learningRate | float | 是 | 学习率 |
maxSeqLen | int | 否 | 序列长度 |
loggingSteps | int | 否 | 保存日志间隔 |
warmupRatio | float | 否 | 预热比例 |
weightDecay | float | 否 | 正则化系数 |
loraRank | int | 否 | LoRA 策略中的秩 |
loraAllLinear | string | 否 | LoRA 所有线性层 |
trainset说明
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
type | int | 是 | 数据集类型,可选值如下: 1:表示平台数据集 2:表示bos数据集 |
id | int | 否 | 数据集版本ID,当type=1时,该字段必传 |
bosPath | string | 否 | 数据集版本bos路径,当type=2时,该字段必传 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
log_id | string | 请求ID |
result | dict | 请求结果 |
result说明
名称 | 类型 | 描述 |
---|---|---|
id | int | 运行ID |