创建任务运行
更新时间：2025-07-15
注意：为提升开发者使用体验，平台升级了模型调优接口。推荐使用新版模型精调接口，功能更全面、且接口更规范，详见模型调优API列表；V1版本相关接口不再升级，已于2024年9月8日将本文档迁移至历史文档；由于V1版本接口后续可能下线停止服务，为避免影响使用，建议接入新版本接口。
接口描述
本接口用于创建训练任务运行。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 完全控制千帆大模型平台模型调优的权限：QianfanModelTuningFullControlAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求结构
POST /wenxinworkshop/finetune/createJob HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"taskId": 362,
"description": "",
"jobRunType": 0,
"baseTraintype": "ERNIE-***",
"trainType": "ERNIE-***",
"trainMode": "SFT",
"pefttype": "ALL",
"trainConfig": {
"epoch": 1,
"learningRate": 0.00003,
"maxSeqLen": 4096
},
"trainset": [
{
"type": 1,
"id": 188
}
],
"trainsetRate": 20
}请求头域
除公共头域外，无其它特殊头域。
请求参数
- Body参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| taskId | int | 是 | 任务ID |
| description | string | 否 | 运行描述 |
| jobRunType | int | 是 | 任务运行类型，可选值如下： · 0：普通训练 · 1：增量训练 |
| increConfig | object | 否 | 增量训练基础任务信息 |
| baseTrainType | string | 否 | 基础算法类型 |
| trainType | string | 否 | 具体算法类型版本 |
| trainMode | string | 否 | 训练方法 |
| peftType | string | 否 | parameter efficient finetuning方式 |
| trainConfig | object | 是 | 训练配置 |
| trainset | array | 是 | 数据集配置 |
| 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 | object | 请求结果 |
result说明
| 名称 | 类型 | 描述 |
|---|---|---|
| id | int | 运行ID |
请求示例
- 普通训练
# 替换下列示例中的Authorization值、x-bce-date值
curl --location 'https://qianfan.baidubce.com/wenxinworkshop/finetune/createJob' \
--header 'Authorization: bce-auth-v1/f0ee7a166b934f75b8703a8079702c13/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8exxxxx525543' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
"taskId": 362,
"description": "",
"jobRunType": 0,
"baseTraintype": "ERNIE-***",
"trainType": "ERNIE-***",
"trainMode": "SFT",
"pefttype": "ALL",
"trainConfig": {
"epoch": 1,
"learningRate": 0.00003,
"maxSeqLen": 4096
},
"trainset": [
{
"type": 1,
"id": 188
}
],
"trainsetRate": 20
}'- 增量训练
curl --location 'https://qianfan.baidubce.com/wenxinworkshop/finetune/createJob' \
--header 'Authorization: bce-auth-v1/f0ee7axxxx3/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8exxxxx525543' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
"taskId": 362,
"description": "",
"jobRunType": 1,
"increConfig": {
"taskId":362,
"jobId":1264
},
"trainConfig": {
"epoch": 1,
"learningRate": 0.00003,
"maxSeqLen": 4096
},
"trainset": [
{
"type": 1,
"id": 188
}
],
"trainsetRate": 20
}'响应示例
{
"log_id":"123",
"result":{
"id":123
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| error_code | 错误码 |
| error_msg | 错误描述信息，帮助理解和解决发生的错误 |
例如参数错误返回：
{
"error_code": 500001,
"error_msg": "param invalid"
}更多其他错误码，也可以查看错误码说明。