获取增强任务列表
更新时间：2026-04-09
POST
https://qianfan.baidubce.com/v2/dataprocessing?Action=DescribeTextAugmentTasks
本接口用于获取增强任务列表。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 只读访问千帆大模型平台的权限：QianfanReadAccessPolicy
- 完全控制千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataFullControlAccessPolicy
- 运维操作千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataOperateAccessPolicy
- 只读访问千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataReadAccessPolicy
鉴权说明
调用本文API，使用"基于安全认证AK/SK"进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值 DescribeTextAugmentTasks
必选
Body 参数
marker
string
本次查询的起始位置，第一条查询该字段设为空
可选
maxKeys
integer
请求列表长度，最大为100，默认值是10，如果指定的值大于100，按100操作
可选
pageReverse
boolean
是否倒序，默认否
可选
filter
object {1}
筛选条件，此处支持对于增强状态进行筛选
可选
显示子属性
隐藏子属性
status
array
根据数据集增强状态进行筛选，可选值如下：
· 进行中：Running
· 已终止：Stopped
· 已完成：Succeeded
· 任务异常：Failed
可选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/dataprocessing?Action=DescribeTextAugmentTasks HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"marker": "",
"maxKeys": 10,
"pageReverse": false,
"filter": {
"status": ["Succeeded"]
}
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/dataprocessing?Action=DescribeTextAugmentTasks'\
--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 '{
"marker": "",
"maxKeys": 10,
"pageReverse": false,
"filter": {
"status": ["Succeeded"]
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，可用于排查问题
可选
result
object {2}
可选
显示子属性
隐藏子属性
augments
array
增强任务列表
可选
显示子属性
隐藏子属性
items
object {9}
显示子属性
隐藏子属性
taskId
string
增强任务id
可选
taskName
string
增强任务名称
可选
status
string
增强状态，说明：
· 进行中：Running
· 已终止：Stopped
· 已完成：Succeeded
· 任务异常：Failed。可选值: Running, Stopped, Succeeded, Failed
可选
taskType
string
增强任务类型，文本数据增强：text
可选
promptModel
string
用于Prompt生成的模型ID，当开启Prompt生成返回该字段
可选
responsetModel
string
用于Response生成的模型ID，当开启Response生成返回该字段
可选
srcDatasetVersionId
string
增强前的源数据集版本ID
可选
dstDatasetVersionId
string
增强后的目标数据集版本ID
可选
startTime
string
开始时间
可选
pageInfo
object {5}
分页信息
可选
显示子属性
隐藏子属性
marker
string
本次查询的起始位置
可选
maxKeys
integer
请求列表长度
可选
isTruncated
boolean
是否被截断
可选
nextMarker
string
下一页标记
可选
pageReverse
boolean
是否倒序
可选
成功示例
{
"requestId": "17942e59-3b46-48e4-af42-2cb380c957a0",
"result": {
"augments": [
{
"taskId": "task-xxx",
"taskName": "zxx_xxx",
"srcDatasetVersionId": "ds-xxx",
"dstDatasetVersionId": "ds-xxx",
"startTime": "2025-06-20 17:07:25",
"status": "Succeeded",
"taskType": "text",
"promptModel": "deepseek-v3",
"responsetModel": ""
},
{
"taskId": "task-xxx",
"taskName": "zxx_xxx",
"srcDatasetVersionId": "ds-xxx",
"dstDatasetVersionId": "ds-xxx",
"startTime": "2025-06-20 17:19:11",
"status": "Succeeded",
"taskType": "text",
"promptModel": "deepseek-v3",
"responsetModel": ""
}
],
"pageInfo": {
"marker": "",
"maxKeys": 10,
"isTruncated": true,
"nextMarker": "task-xxx",
"pageReverse": false
}
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章