接口说明
可按模型、操作、渠道行和状态过滤。公开字段使用 channel_row_id;不要依赖内部父渠道标识。
认证:Bearer API Key
请求
查询参数
| 名称 | 类型 | 说明 |
|---|---|---|
page | integer | 页码,从 1 开始。 |
page_size | integer | 每页 1–100 条,默认 20。 |
model_id | string | 模型 ID。 |
operation | generation | edit | variation | 图片操作。 |
channel_row_id | string | 公开渠道行 ID。 |
status | string | 用量记录状态。 |
响应
JSON 接口使用统一响应信封。HTTP 状态表达请求结果,业务错误不会伪装成 HTTP 200。
| HTTP | 含义 |
|---|---|
200 | 请求成功 |
400 | 业务参数或过滤条件无效 |
401 | 缺少或无效的 API Key |
403 | API Key 已禁用或无权访问 |
422 | 请求结构校验失败 |
500 | 服务内部错误 |
完整成功响应示例(可选字段可能因状态不同而变化)
{
"code": 0,
"message": "success",
"data": {
"summary": {
"currency": "USD",
"request_count": 0,
"success_count": 0,
"failure_count": 0,
"completed_image_count": 0,
"reserved_micro": 0,
"reserved_usd": "0.000000",
"charged_micro": 0,
"charged_usd": "0.000000",
"refunded_micro": 0,
"refunded_usd": "0.000000",
"released_micro": 0,
"released_usd": "0.000000",
"net_consumed_micro": 0,
"net_consumed_usd": "0.000000"
},
"items": [],
"total": 0,
"page": 1,
"page_size": 20
},
"request_id": "8f25b42f-2ed1-4ad7-99de-61d7f779bc7b",
"timestamp": "2026-08-10T00:00:00Z"
}重要边界
- 此接口按当前 API Key 过滤,不是整个账户的控制台会话视图。