获取批量推理任务详情

获取批量推理任务详情

更新时间：2026-04-20

POST

https://qianfan.baidubce.com/v2/batchinference?Action=DescribeBatchInferenceTask

本接口用于获取批量推理任务详情，如任务名称、任务描述、任务运行状态等。

权限说明

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

完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
运维操作千帆大模型平台推理服务的权限：QianfanServiceOperateAccessPolicy
只读访问千帆大模型平台推理服务的权限：QianfanServiceReadAccessPolicy

鉴权说明

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

请求参数

Headers 参数

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

Query 参数

Action string

方法名称，固定值 DescribeBatchInferenceTask

必选

Body 参数

taskId string

任务ID，说明：只能通过调用创建批量推理任务接口，返回的字段 taskId 获取

必选

请求结构

POST /v2/batchinference?Action=DescribeBatchInferenceTask HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
    "taskId": "infer-9iaxxxwt9mp"
}

示例代码

请求示例

curl -i --location 'https://qianfan.baidubce.com/v2/batchinference?Action=DescribeBatchInferenceTask'\
--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": "infer-9iaxxxwt9mp"
}'

返回响应

Headers 参数

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

返回参数

requestId string

请求ID

可选

result object {25}

可选

显示子属性隐藏子属性

taskId string

任务ID

可选

name string

任务名称

可选

description string

任务描述

可选

endpoint string

推理服务endpoint

可选

modelId string

模型版本ID

可选

inferenceParams object {0}

推理服务参数配置

可选

显示子属性隐藏子属性

暂无参数

searchCounts integer

触发搜索次数

可选

searchTokens integer

触发搜索膨胀Tokens数

可选

runStatus string

任务运行状态
· Queuing：排队中
· Running：运行中
· Done：运行完成
· Stopping：运行终止中
· Stopped：运行终止
· Failed：运行失败
· Expired：运行超时

可选

errorCode integer

任务运行失败时返回的错误码，即当 runStatus=Failed，返回该字段

可选

errorReason string

任务运行失败时返回的错误原因，即当 runStatus=Failed，返回该字段

可选

inputBosUri string

数据输入bos目录

可选

outputBosUri string

数据输出bos目录，固定输出格式为jsonl

可选

outputDir string

数据输出任务目录

可选

inputTokenUsage integer

成功处理的输入总token数，当任务运行状态为Done时返回该字段

可选

outputTokenUsage integer

成功处理的输出总token数，当任务运行状态为Done时返回该字段

可选

progress integer

已处理的数据条数

可选

totalDataCount integer

总数据条数

可选

taskSource string

任务来源，说明：
· batchInference：批量推理
· modelEval：模型评估
· inferenceDataset：推理数据集

可选

dataFormat string

数据格式，说明：
· default
· src_tgt
· role

可选

creator string

任务创建人

可选

createTime string

任务创建时间

可选

finishTime string

任务结束时间

可选

runTime integer

运行时间

可选

version integer

推理任务接口版本：
· 1：推理服务V1版本接口，默认使用V1版本
· 2：推理服务V2版本接口

可选

成功示例

{
    "requestId": "1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result": {
        "taskId": "infer-9ia3kc1wt9mp",
        "name": "name",
        "description": "description",
        "endpoint": "http://xxx",
        "inferenceParams": {
            "temperature": 0.9,
            "top_p": 0.3
        },
        "searchCounts": 10,
        "searchTokens": 100000,
        "runStatus": "Running",
        "inputBosUri": "bos:/user_a/bucket",
        "outputBosUri": "bos:/user_b/output",
        "outputDir": "662f7bfb8055376bcd516942",
        "inputTokenUsage": 10000,
        "outputTokenUsage": 10000,
        "progress": 100,
        "totalDataCount": 400,
        "taskSource": "batchInference",
        "dataFormat": "default",
        "creator": "accountName",
        "createTime": "2024-01-16T09:48:35Z",
        "finishTime": "2024-01-16T10:48:35Z",
        "runtime": 866,
        "version": 1
    }
}

错误码

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

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

例如错误返回：

text

{
    "requestId":"6ba7b810-xxxc04fd430c8",
    "code":"AccessDenied",
    "message":"Access denied."
}

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

评价此篇文章

有帮助没帮助

百度智能云

千帆AI应用开发者中心-API参考 qianfan-api