查询账单汇总
端点
GET
/v1/billing/costs查询当前鉴权 API Key 在指定时间范围内的账单汇总，只返回汇总数据，不返回逐请求明细。
请求
鉴权使用 Authorization: Bearer sk-moyiapi-xxxxxx。
参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
start_time |
查询串 | integer | 是 | 开始时间（Unix 秒），包含该时间点 |
end_time |
查询串 | integer | 是 | 结束时间（Unix 秒），不包含该时间点 |
时间范围最长 90 天，超过返回 400 invalid_request。
响应
{
"start_time": 1784044800,
"end_time": 1784131200,
"total_amount": {"value": "1.280000", "currency": "USD"},
"requests": 86
}
| 字段 | 说明 |
|---|---|
start_time / end_time |
实际生效的查询范围 |
total_amount |
范围内的费用合计，value 为字符串金额 |
requests |
范围内的请求次数 |
价格可能调整，历史账单以接口返回的金额为准，不能用当前价格表反推。
示例
curl "https://moyiapi.cn/v1/billing/costs?start_time=1784044800&end_time=1784131200" \
-H "Authorization: Bearer sk-moyiapi-xxxxxx"
错误
| HTTP 状态 | error.code |
触发条件 |
|---|---|---|
| 400 | invalid_request |
参数无效，例如 end_time 不大于 start_time，或范围超过 90 天 |