查询特定量包信息
更新时间：2026-04-17
POST
https://qianfan.baidubce.com/v2/charge?Action=DescribePackageResource
本接口用于查询已购买的特定资源包实例信息。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值DescribePackageResource
必选
Body 参数
packageId
string
量包 ID
必选
请求结构
POST /v2/charge?Action=DescribePackageResource HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"packageId": "c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132"
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/charge?Action=DescribePackageResource'\
--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 '{
"packageId": "c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
object {1}
可选
显示子属性
隐藏子属性
instance
object {8}
可选
显示子属性
隐藏子属性
packageId
string
量包 ID
可选
serviceName
string
服务系列名称
可选
specification
string
规格
不同类型的量包单位分别为：
视频积分包：积分
大语言模型量包：千 tokens
检索增强以及阅读插件：次
可选
used
float
使用量
不同类型量包单位分别为：
视频积分包：积分
大语言模型量包：千 tokens
检索增强以及阅读插件：次
可选
status
string
资源状态
取值范围：
1. Pending：待使用
2. Active：使用中
3. Exhausted：已用尽
4. Expired：已过期。
可选
startTime
string
量包生效时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-29T06:58:56Z
可选
expiredTime
string
量包到期时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-29T06:58:56Z
可选
creator
string
购买量包的用户账号，例如：zhangsan
可选
响应示例
{
"requestId": "c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132",
"result": {
"instance": {
"creator": "zhangsan",
"expiredTime": "2025-01-11T11:32:09Z",
"packageId": "wenxinfactory-oSNMRB7TdK",
"serviceName": "ernie-4.0-8k",
"specification": "1234",
"startTime": "2024-07-11T11:32:09Z",
"status": "Exhausted",
"used": 1234
}
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章