创建模型精调作业
更新时间:2025-06-26
功能介绍
用于创建模型精调作业。
例如,新增作业名称为test_crea,基础模型版本为ERNIE-Speed-8K,调优的训练模式类型为SFT,作业描述为eb_speed_tasks,调用本接口成功后,在控制台-模型调优-模型精调-SFT页面,作业列表新增一条作业,如下图所示。

使用说明
本文API支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用,调用流程请参考SDK安装及使用流程。
权限说明
调用本文API,需符合以下权限要求,权限介绍及分配,请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限:
- 完全控制千帆大模型平台的权限:QianfanFullControlAccessPolicy
- 完全控制千帆大模型平台模型调优的权限:QianfanModelTuningFullControlAccessPolicy
SDK调用
调用示例
1import os
2from qianfan  import resources
3
4# 通过环境变量初始化认证信息
5# 使用安全认证AK/SK调用,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk,如何获取请查看https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
6os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
7os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
8
9resp = resources.console.utils.call_action(
10    # 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求结构-请求地址的后缀
11    "/v2/finetuning", 
12    # 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求参数-Query参数的Action 
13    "CreateFineTuningJob", 
14    # 请查看本文请求参数说明,根据实际使用选择参数;对应API调用文档-请求参数-Body参数
15    {
16        "name":"test_name",
17        "description":"test_description",
18        "model":"ERNIE-Speed-8K",
19        "trainMode":"SFT"
20    }
21)
22
23print(resp.body)1package main
2import (
3    "context"
4    "fmt"
5    "os"
6    "github.com/baidubce/bce-qianfan-sdk/go/qianfan"
7)
8func main() {
9     // 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
10    os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
11    os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
12    
13    ca := qianfan.NewConsoleAction()
14    
15    res, err := ca.Call(context.TODO(),
16    // 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求结构-请求地址的后缀
17    "/v2/finetuning",
18    // 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求参数-Query参数的Action 
19    "CreateFineTuningJob",
20    // 请查看本文请求参数说明,根据实际使用选择参数;对应API调用文档-请求参数-Body参数
21    map[string]interface{}{
22            "name":"test_name",
23            "description":"test_description",
24            "model":"ERNIE-Speed-8K",
25            "trainMode":"SFT" ,
26    })
27    if err != nil {
28        panic(err)
29    }
30    fmt.Println(string(res.Body))
31    
32}1import com.baidubce.qianfan.Qianfan;
2import com.baidubce.qianfan.model.console.ConsoleResponse;
3import com.baidubce.qianfan.util.CollUtils;
4import com.baidubce.qianfan.util.Json;
5import java.util.Map;
6
7public class Dome {
8    public static void main(String args[]){
9        // 使用安全认证AK/SK鉴权,替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
10        Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
11        
12        ConsoleResponse<Map<String, Object>> response = qianfan.console()
13                // 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求结构-请求地址的后缀
14                .route("/v2/finetuning")
15                // 调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求参数-Query参数的Action 
16                .action("CreateFineTuningJob")
17                // 需要传入参数的场景,可以自行封装请求类,或者使用Map.of()来构建请求Body
18                // Java 8可以使用SDK提供的CollUtils.mapOf()来替代Map.of()
19                // 请查看本文请求参数说明,根据实际使用选择参数;对应API调用文档-请求参数-Body参数
20                .body(CollUtils.mapOf(
21                        "name","test_name",
22                        "description","test_description",
23                        "model","ERNIE-Speed-8K",
24                        "trainMode","SFT" 
25                ))
26                .execute();
27
28        System.out.println(Json.serialize(response));
29    }
30}1import {consoleAction, setEnvVariable} from "@baiducloud/qianfan";
2
3// 使用安全认证AK/SK鉴权,通过环境变量初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
4setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
5setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');
6
7async function main() {
8  //base_api_route:调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求结构-请求地址的后缀
9  //action:调用本文API,该参数值为固定值,无需修改;对应API调用文档-请求参数-Query参数的Action 
10  //data:请查看本文请求参数说明,根据实际使用选择参数;对应API调用文档-请求参数-Body参数
11  const res = await consoleAction({base_api_route: '/v2/finetuning', action: 'CreateFineTuningJob', data: {
12    "name":"test_name",
13    "description":"test_description",
14    "model":"ERNIE-Speed-8K",
15    "trainMode":"SFT"
16    }
17  });    
18    
19  console.log(res);
20}
21
22main();返回示例
1{
2    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
3    "result":{
4        "jobId":"job-ftp4icwebtnc"
5    }
6}1{
2    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
3    "result":{
4        "jobId":"job-ftp4icwebtnc"
5    }
6}1{
2    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
3    "result":{
4        "jobId":"job-ftp4icwebtnc"
5    }
6}1{
2    requestId:'1bef3f87-c5b2-4419-936b-50f5dfgf10d4',
3    result:{
4        jobId:'job-ftpxxxxtnc'
5    }
6}请求参数
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| name | string | 是 | 作业名称,取值范围:字符串长度为 [2, 20] | 
| description | string | 否 | 作业描述,取值范围:字符串长度为 [0, 500] | 
| model | string | 是 | 基础模型版本,支持对话续写类、图像类模型版本,具体值请查看模型支持情况-model值 | 
| trainMode | string | 是 | 调优的训练模式类型,说明:该字段取值,请参考模型支持情况 | 
返回参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| requestId | string | 请求ID | 
| result | object | 请求结果 | 
result说明
| 名称 | 类型 | 描述 | 
|---|---|---|
| jobId | string | 作业ID | 
