创建模型精调作业

更新时间：2025-10-29

接口描述

本接口用于创建模型精调作业。

例如，新增作业名称为test_crea，基础模型版本为ERNIE-Speed-8K，调优的训练模式类型为SFT，作业描述为eb_speed_tasks，调用本接口成功后，在控制台-模型调优-模型精调-SFT页面，作业列表新增一条作业，如下图所示。

权限说明

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
完全控制千帆大模型平台模型调优的权限：QianfanModelTuningFullControlAccessPolicy

鉴权说明

调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

请求结构

                Bash
                
            

                POST /v2/finetuning?Action=CreateFineTuningJob HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
    "name":"test_name",
    "description":"test_description",
    "model":"ERNIE-Speed-8K",
    "trainMode":"SFT" 
}
            

请求头域

除公共头域外，无其它特殊头域。

请求参数

Query参数

名称	类型	必填	描述
Action	string	是	方法名称，固定值CreateFineTuningJob

Body参数

名称	类型	必填	描述
name	string	是	作业名称，取值范围：字符串长度为 [2, 20]
description	string	否	作业描述，取值范围：字符串长度为 [0, 500]
model	string	是	基础模型版本，支持对话续写类、图像生成类模型版本，具体值请查看模型支持情况-model值
trainMode	string	是	调优的训练模式类型，说明：该字段取值，请参考模型支持情况

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称	类型	描述
requestId	string	请求ID
result	object	请求结果

result说明

名称	类型	描述
jobId	string	作业ID

请求示例

                Bash
                
            

                curl --location 'https://qianfan.baidubce.com/v2/finetuning?Action=CreateFineTuningJob' \
--header 'Authorization: bce-auth-v1/f0exxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8exxxx' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
    "name":"test_name",
    "description":"test_description",
    "model":"ERNIE-Speed-8K",
    "trainMode":"SFT" 
}'
            

响应示例

                JSON
                
            

                {
    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result":{
        "jobId":"job-ftp4icwebtnc"
    }
}
            

错误码

若请求错误，服务器将返回的JSON文本包含以下参数：

名称	描述
requestId	请求ID
code	错误码
message	错误描述信息，帮助理解和解决发生的错误

例如错误返回：

Plain Text

1{
2    "requestId":"6ba7b810-xxxc04fd430c8",
3    "code":"AccessDenied",
4    "message":"Access denied."
5}

更多其他错误码，也可以查看错误码说明。

创建模型精调任务

删除模型精调任务

百度智能云

百度千帆·大模型服务及Agent开发平台