获取模型精调任务详情
更新时间：2026-04-17
POST
https://qianfan.baidubce.com/v2/finetuning?Action=DescribeFineTuningTask
本接口用于获取模型精调任务详情。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 只读访问千帆大模型平台的权限：QianfanReadAccessPolicy
- 完全控制千帆大模型平台模型调优的权限：QianfanModelTuningFullControlAccessPolicy
- 只读访问千帆大模型平台模型调优的权限：QianfanModelTuningReadAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值DescribeFineTuningTask
必选
Body 参数
请求结构
POST /v2/finetuning?Action=DescribeFineTuningTask HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"taskId": "task-0tgmn4a7h4i6"
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/finetuning?Action=DescribeFineTuningTask'\
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44a21a5xxxx74525543'\
--header 'x-bce-date: 2023-09-19T13:37:10Z'\
--header 'Content-Type: application/json'\
--data '{
"taskId": "task-0tgmn4a7h4i6"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
object {16}
可选
显示子属性
隐藏子属性
taskId
string
任务ID
可选
jobId
string
作业ID
可选
jobName
string
作业名称
可选
jobDescription
string
作业描述
可选
model
string
基础模型版本
可选
trainMode
string
调优的训练模式
可选
parameterScale
string
调优的参数规模
可选
runStatus
string
任务运行状态，说明：
· Running: 运行中
· Done: 运行完成
· Stopped: 运行中止
· Failed: 运行失败
· Waiting：排队中。可选值: Running, Done, Stopped, Failed, Waiting
可选
runProgress
string
训练进度，说明：只有任务运行状态运行中，才会返回此参数，即 runStatus 为Running时，返回该参数
可选
vdlLink
string
训练可视化链接
可选
metrics
object {4}
评估指标，运行完成才会返回，目前只支持文本生成类型
可选
显示子属性
隐藏子属性
BLEU-4
string
评估指标BLEU-4
可选
ROUGE-1
string
评估指标ROUGE-1
可选
ROUGE-2
string
评估指标ROUGE-2
可选
ROUGE-L
string
评估指标ROUGE-L
可选
checkpointList
array
checkpoint信息
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
step
integer
step
可选
perplexity
float
perplexity
可选
trainingLoss
float
trainingLoss
可选
createTime
string
任务创建时间，格式: ISO 8601
可选
finishTime
string
任务结束时间，格式: ISO 8601
可选
errorMessage
string
错误讯息
可选
errorCode
integer
错误码
可选
成功示例
{
"requestId": "1bef3f87-c5b2-4419-936b-50f9884f10d4",
"result": {
"taskId": "task-0tgmn4a7h4i6",
"jobId": "job-ftp4icwebtnc",
"jobName": "job-name",
"jobDescription": "job-description",
"model": "ERNIE-Speed-8K",
"trainMode": "SFT",
"parameterScale": "FullFineTuning",
"runStatus": "Running",
"runProgress": "99%",
"vdlLink": "https://console.bce.baidu.com/qianfan/visualdl/index?displayToken=eyJydW5JZCI6InJ1bi10NGczZmZuMXpzampwZHFzIn0=",
"createTime": "2024-01-16T09:48:35Z",
"finishTime": "2024-01-16T10:48:35Z"
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章