读取请求记录

GET https://enterprise.beefapi.com/v1/usage/requests

使用企业 Key 的 Bearer 认证。调用范围与用量汇总一致，不读取其他 Key 或其他钱包的记录。

查一条请求

export REQUEST_ID='YOUR_REQUEST_ID'
curl --fail-with-body --get https://enterprise.beefapi.com/v1/usage/requests \
  -H "Authorization: Bearer $BEEFAPI_KEY" \
  --data-urlencode "request_id=$REQUEST_ID"

request_id 是 HTTP 请求标识，不是视频任务 ID。应使用发起调用时保存的请求标识；一项业务操作可能产生多条账务记录，不能假定永远只返回一行。

时间与分页参数

参数	类型	说明
`start_time` / `end_time`	正整数	Unix 秒，起始包含、结束不包含；默认最近约 30 天，跨度 ≤31 天
`model`	string	精确模型名筛选
`request_id`	string	按请求标识筛选，最长 64 字符
`limit`	正整数	默认 50，最多 100
`before`	正整数	上一页返回的 `next_cursor`，用于继续向旧记录翻页

curl --fail-with-body --get https://enterprise.beefapi.com/v1/usage/requests \
  -H "Authorization: Bearer $BEEFAPI_KEY" \
  --data-urlencode 'limit=50'

当 has_more: true 时，将 next_cursor 原值作为下一次 before。其值是数字字符串，不是响应项带 usage_ 前缀的 id。分页时固定同一组起止时间和筛选项，避免窗口移动。

响应结构

以下是待结算记录示例，数值与 ID 均为示例：

{
  "currency":"CNY",
  "start_time":1790000000,
  "end_time":1790086400,
  "data":[{
    "id":"usage_123",
    "request_id":"request_example",
    "created_at":1790000010,
    "model":"seedance-2.0-mini",
    "result":"unknown",
    "billing_status":"pending",
    "amount":null,
    "reserved_amount":"4.000000",
    "refunded_amount":null,
    "input_tokens":0,
    "output_tokens":0,
    "cache_read_tokens":null,
    "cache_write_tokens":null,
    "usage_estimated":false
  }],
  "next_cursor":"",
  "has_more":false
}

结算字段

字段 / 状态	含义
`billing_status: pending`	仍待结算，查看 `reserved_amount`
`billing_status: settled`	已有结算金额，查看 `amount`
`billing_status: refunded`	已记录退回，结合 `amount` 与 `refunded_amount` 查看
`billing_status: unknown`	现有记录不足以确认金额，不是免费
`result`	执行结果，可能 `completed`、`failed` 或 `unknown`；与账务状态独立
`amount`	十进制金额字符串或 `null`；负数可表示退回记录
`reserved_amount` / `refunded_amount`	预留与退回金额，缺失证据时可能为 `null`
`usage_estimated`	是否含估算用量
`pricebook_id` / `pricing_version`	存在时用于核对该记录对应的报价版本

输入、输出及缓存 token 按记录提供；null 不等于 0，原始 token 数也不一定能独立重算全部费用。错误记录可显示 result: failed 但 billing_status: unknown，不能因此判定已退款。

空列表可能由时间范围、Key 或查询条件造成，也可能尚未写入记录。保存 Request ID，稍后复查或联系支持，不要以空列表为依据重新提交昂贵任务。

查一条请求

时间与分页参数

响应结构

结算字段

本页内容