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

地址

POST /open/v1/consume_detail

Header

access_token: {{access_token}}
Content-Type: application/json

请求参数 Body

参数名	参数类型	是否必填	说明
start_time	string	是	开始时间，格式：YYYY-MM-DD HH:MM:SS。开始时间仅支持近 1 年内，且查询时间范围最长为 31 天。
end_time	string	是	结束时间，格式：YYYY-MM-DD HH:MM:SS。
consume_type	string	否	消耗类型。未传时返回当前应用下全部支持类型的消耗明细，取值见下表。
page	int	否	页码，默认 1。
page_size	int	否	每页数量，默认 200，最大 200。

consume_type 取值

取值	说明
make_video	生成视频
make_audio	生成音频
customised_person	定制数字人
customised_audio	定制声音
lip_sync	对口型
creative_briefing	创意雷达
aigc_photo	生图
aigc_motion	图生视频
lora	定制面容
ai_creation	AI 创作

查询范围说明

• 接口只返回当前 access_token 对应 Open 应用的蝉豆消耗明细。
• consume_type 未传时，返回当前 Open 应用下所有支持类型的消耗明细。
• consume_type 传入不支持的值时返回错误，不会降级为默认查询。

请求示例

{
    "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
}

返回示例

{
    "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			响应状态码
msg			响应消息
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 状态错误、开始时间或结束时间格式错误、查询时间范围超过 31 天、消耗类型不存在
40000	参数错误
50000	系统内部错误