查询特定量包信息

更新时间：2025-08-29

接口描述

本接口用于查询已购买的特定资源包实例信息。

权限说明

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

完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy

鉴权说明

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

请求结构

Bash

POST /v2/charge?Action=DescribePackageResource HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
x-bce-date: 2025-08-29T06:58:56Z
Content-Type: application/json

{
     "packageId":"c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132"
}

请求头域

名称	类型	必填	描述
Content-Type	string	是	HTTP 请求内容的类型，固定值：application/json
x-bce-date	string	是	当前时间，采用UTC时间，遵循ISO8601规范，格式如2025-08-29T06:58:56Z
Authorization	string	是	用于验证请求合法性的认证信息。更多参见鉴权认证，签名工具可参考IAM 签名工具

请求参数

Query参数

名称	类型	必填	描述
Action	string	是	方法名称，固定值DescribePackageResource

Body参数

名称	类型	必填	描述
packageId	string	是	量包 ID

响应头域

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

响应参数

名称	类型	描述
requestId	string	请求ID
result	object	请求结果

result说明

名称	类型	描述
instance	Object	实例信息

instance说明

名称	类型	描述
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

请求示例

bash

curl --location 'https://qianfan.baidubce.com/v2/charge?Action=DescribePackageResource' \
--header 'Authorization: Authorization String' \
--header 'x-bce-date: 2025-08-29T06:58:56Z' \
--header 'Content-Type: application/json' \
--data '{
    "packageId":"c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132"
}'

响应示例

JSON

{
    "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	错误描述信息，帮助理解和解决发生的错误

例如错误返回：

{
    "requestId": "c6b9ff4c-xxxx-xxxx-xxxx-6c7df6282132",
    "code": "MalformedJSON",
    "message": "The JSON you provided was not well-formed."
}

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

查询量包列表

模型服务