查看模型压缩任务列表

查看模型压缩任务列表

更新时间：2026-02-27

POST

https://qianfan.baidubce.com/v2/model?Action=DescribeModelCompTasks

本接口用于查看模型压缩任务列表。

权限说明

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

完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
只读访问千帆大模型平台的权限：QianfanReadAccessPolicy
完全控制千帆大模型平台模型调优的权限：QianfanModelTuningFullControlAccessPolicy
只读访问千帆大模型平台模型调优的权限：QianfanModelTuningReadAccessPolicy

鉴权说明

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

请求参数

Headers 参数

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

Query 参数

Action string

方法名称，固定值DescribeModelCompTasks

必选

Body 参数

marker string

本次查询的起始位置加速任务id，说明：
（1）默认从第一条数据开始
（2）示例值：amva-n50985crhqq3

可选

maxKeys integer

返回的列表长度，说明：
（1）最大为100；如果指定的值大于100，按100操作
（2）默认值是10

可选

pageReverse boolean

是否倒序，可选值：
· true：是
· false：否，默认为false

可选

sourceModelId string

模型版本ID，用于筛选特定模型版本的压缩任务，通过以下方式获取该字段值：
· 方式一，通过调用新建我的模型版本接口，返回的modelId字段获取
· 方式二，在控制台-我的模型-点击某模型详情，在版本列表中查看

可选

请求结构

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

{
    "marker":"amva-n50985crhqq3"
}

示例代码

请求示例

curl -i --location 'https://qianfan.baidubce.com/v2/model?Action=DescribeModelCompTasks'\
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44a21axxxxxe374525543'\ 
--header 'x-bce-date: 2023-09-19T13:37:10Z'\
--header 'Content-Type: application/json'\ 
--data '{
    "marker":"amva-n50985crhqq3"
}'

返回响应

Headers 参数

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

返回参数

requestId string

请求ID

可选

code string

错误码，接口报错时返回，HTTP状态码>=400

可选

message string

错误信息，接口报错时返回，HTTP状态码>=400

可选

result object {2}

请求结果

可选

显示子属性隐藏子属性

modelCompTaskList array

模型压缩任务列表

可选

显示子属性隐藏子属性

items object {8}

显示子属性隐藏子属性

id string

模型压缩任务ID

可选

name string

模型压缩任务名称

可选

description string

模型压缩任务描述

可选

status string

模型压缩任务运行状态，说明：
· creating：创建中
· running：运行中
· succeeded：已完成
· failed：已失败
· stopping：终止中
· stopped：已终止。

可选

sourceModelId string

模型压缩任务源模型id

可选

modelId string

压缩后产出模型id；当任务失败，该字段为空

可选

createTime string

任务创建时间，格式: ISO 8601

可选

finishTime string

任务完成时间，格式: ISO 8601

可选

pageInfo object {4}

分页信息

可选

显示子属性隐藏子属性

marker string

本次查询的起始位置

可选

maxKeys integer

请求返回的最大数目

可选

isTruncated boolean

指明是否只返回了部分数据，说明：
· false：表示本次已经返回所有结果
· true：表示本次还没有返回所有结果

可选

nextMarker string

当isTruncated为true时，返回该字段，作为下次查询marker的值

可选

JSON

{
    "requestId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "result": {
        "modelCompTaskList": [
            {
                "id": "amva-j05zi5ebfqf1",
                "name": "demo",
                "description": "test",
                "status": "succeeded",
                "sourceModelId": "amv-m45zi5edgff1",
                "modelId": "amv-s4678i5edgff",
                "config": {
                    "strategy": "Quantization",
                    "quantConf": "wint8"
                },
                "createTime": "2024-03-22T17:13:33+08:00"
            }
        ],
        "pageInfo":{
            "marker":"amva-n50985crhqq3",
            "maxKeys":1,
            "isTruncated":false
        }
    }
}

错误码

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

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

例如错误返回：

text

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

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

评价此篇文章

有帮助没帮助

百度智能云

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

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

权限说明

鉴权说明

请求参数

示例代码

返回响应

错误码