Skip to content

获取用户蝉豆消耗明细数据

地址

http
POST /open/v1/consume_detail
http
access_token: {{access_token}}
Content-Type: application/json

请求参数Body

参数名参数类型是否必填说明
start_timestring开始时间,格式:YYYY-MM-DD HH:MM:SS 时间范围最长为31天
end_timestring结束时间,格式:YYYY-MM-DD HH:MM:SS 时间范围最长为31天
consume_typestring消耗类型,参数可选值:
- make_video【生成视频】
- make_audio【生成音频】
- customised_person【定制数字人】
- customised_audio【定制声音】
- 不填则取以上所有类型消耗
pageint页码
page_sizeint每页数量 范围[1,200]

请求示例

json
{
    "start_time": "2025-10-01 00:00:00",
    "end_time": "2025-10-30 00:00:00",
    "consume_type": "make_video",
    "page": 1,
    "page_size": 3
}

返回示例

json
{
    "trace_id": "f3c7b98bd48753f7c18e2714762ddb9f",
    "code": 0,
    "msg": "success",
    "data": {
        "list": [
            {
                "consume_time": "2025-10-10 14:41:33",
                "bean_amount": 10,
                "consume_type": "API-生成视频扣除蝉豆",
                "task_id": "1976538431040819200",
                "status": 0
            },
            {
                "consume_time": "2025-10-10 13:50:56",
                "bean_amount": 10,
                "consume_type": "API-生成视频扣除蝉豆",
                "task_id": "1976525731416973312",
                "status": 0
            },
            {
                "consume_time": "2025-10-10 13:34:05",
                "bean_amount": 9,
                "consume_type": "API-生成视频扣除蝉豆",
                "task_id": "1976521513599963136",
                "status": 0
            }
        ],
        "page_info": {
            "page": 1,
            "size": 3,
            "total_count": 13,
            "total_page": 5
        }
    }
}

响应字段说明

一级字段二级字段三级字段说明
code响应状态码
message响应消息
data响应数据
list列表数据蝉豆消耗-列表数据
consume_time消耗时间
bean_amount消耗蝉豆数量
consume_type消耗类型
task_id任务ID
status扣费状态 0:已扣费 2:已补偿
page_info分页信息
page当前页码
size页面大小
total_count总数
total_page总页数

响应状态码说明

code说明
0响应成功
10400- AccessToken验证失败
- APP状态错误
- 开始时间或结束时间格式错误
- 消耗类型不存在
40000参数错误
50000系统内部错误