查询量包列表
本接口用于查询已购买的资源包实例列表。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参见HTTP调用鉴权说明。
请求参数
方法名称，固定值DescribePackageResources
服务系列名称
Tokens量包ernie-liteernie-lite-pro-128kernie-speed-pro-128kqianfan-agent-speed-32kernie-x1-32k-previewdeepseek-v3deepseek-r1ernie-x1-turbo-32kernie-4.5-turbo-vl-32kernie-4.5-turbo-32kernie-4.5-turbo-128k
视频生成服务积分包klingviduminimaxqianfan-video
检索增强次包search
阅读助手插件次包chatFilePlus
资源状态Pending：待使用Active：使用中Exhausted：已用尽Expired：已过期。
购买量包的用户账号
POST /v2/charge?Action=DescribePackageResources HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"serviceName": "ernie-4.5-turbo-128k",
"creator": "zhangsan",
"status": "Expired"
}示例代码
curl -X POST 'https://qianfan.baidubce.com/v2/charge?Action=DescribePackageResources' \
-H 'Content-Type: application/json' \
-H 'x-bce-date:2025-08-27T03:42:56Z' \
-H 'Authorization: bce-auth-v1/ALTAKqRWXm7xxxxxxQerNeo6YYK/2025-08-27T03:42:56Z/1800/host;x-bce-date/9afaf84970872ef2340b0xxxxxx1bde53ed673d850c36aff0b0a06706751d59b' \
-d '{
"serviceName": "ernie-4.5-turbo-128k",
"creator": "zhangsan",
"status": "Expired"
}'返回响应
请求ID
请求结果
显示子属性
隐藏子属性
实例列表
显示子属性
隐藏子属性
显示子属性
隐藏子属性
量包ID
服务系列名称
规格
视频积分包（单位：积分）
大语言模型量包（单位：千Tokens）
检索增强以及阅读插件（单位：次）
使用量
视频积分包（单位：积分）
大语言模型量包（单位：千Tokens）
检索增强以及阅读插件（单位：次）
资源状态Pending：待使用Active：使用中Exhausted：已用尽Expired：已过期。
量包生效时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-27T09:44:22Z
量包到期时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-27T09:44:22Z
购买量包的用户账号
{
"requestId": "2b7e48af-xxxx-xxxx-xxxx-1dc5fefa976d",
"result": {
"instances": [
{
"creator": "zhangsan",
"expiredTime": "2025-06-09T14:12:17Z",
"packageId": "wenxinfactory-8xxxxxxxqG",
"serviceName": "ernie-4.5-turbo-128k",
"specification": "100",
"startTime": "2025-05-09T14:12:17Z",
"status": "Expired",
"used": 100
}
]
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章