查询量包列表
更新时间：2025-09-15
查询量包列表
接口描述
本接口用于查询已购买的资源包实例列表。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参见HTTP调用鉴权说明。
请求结构
POST /v2/charge?Action=DescribePackageResources HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
x-bce-date: 2025-08-27T03:42:56Z
Content-Type: application/json
{
"serviceName": "ernie-4.5-turbo-128k",
"status": "Active",
"creator": "zhangsan"
}请求头域
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | string | 是 | HTTP请求内容的类型，固定值：application/json |
| x-bce-date | string | 是 | 当前时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-27T09:44:22Z |
| Authorization | string | 是 | 用于验证请求合法性的认证信息。更多参见鉴权认证，签名工具参见IAM签名工具 |
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Action | string | 是 | 方法名称，固定值DescribePackageResources |
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| serviceName | string | 否 | 服务系列名称 Tokens量包 ernie-lite ernie-lite-pro-128k ernie-speed-pro-128k qianfan-agent-speed-32k ernie-x1-32k-preview deepseek-v3 deepseek-r1 ernie-x1-turbo-32k ernie-4.5-turbo-vl-32k ernie-4.5-turbo-32k ernie-4.5-turbo-128k 视频生成服务积分包 kling vidu minimax qianfan-video 检索增强次包 search 阅读助手插件次包 chatFilePlus |
| status | string | 否 | 资源状态 Pending：待使用 Active：使用中 Exhausted：已用尽 Expired：已过期 |
| creator | string | 否 | 购买量包的用户账号，例如：zhangsan |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | string | 请求ID |
| result | object | 请求结果 |
result说明
| 名称 | 类型 | 描述 |
|---|---|---|
| instances | list | 实例列表 |
instances说明
| 名称 | 类型 | 描述 |
|---|---|---|
| packageId | string | 量包ID |
| serviceName | string | 服务系列名称 |
| specification | string | 规格 视频积分包（单位：积分） 大语言模型量包（单位：千Tokens） 检索增强以及阅读插件（单位：次） |
| used | float | 使用量 视频积分包（单位：积分） 大语言模型量包（单位：千Tokens） 检索增强以及阅读插件（单位：次） |
| status | string | 资源状态 Pending：待使用 Active：使用中 Exhausted：已用尽 Expired：已过期 |
| startTime | string | 量包生效时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-27T09:44:22Z |
| expiredTime | string | 量包到期时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-27T09:44:22Z |
| creator | string | 购买量包的用户账号 |
请求示例
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"
}'响应示例
{
"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文本包含以下参数：
| 名称 | 描述 |
|---|---|
| message | 错误描述信息，帮助理解和解决发生的错误 |
| code | 错误码 |
| requestId | 请求ID |
错误示例
{
"requestId": "c33b9433-xxxx-xxxx-xxxx-a61a81761bf0",
"code": "MalformedJSON",
"message": "The JSON you provided was not well-formed."
}更多其他错误码，可参见错误码说明。