Overview
Filter by model, operation, route row, and status. Public fields use channel_row_id; do not depend on an internal parent-channel identifier.
Authentication: Bearer API key
Request
Query parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number, starting at 1. |
page_size | integer | Items per page, 1–100; default 20. |
model_id | string | Model ID. |
operation | generation | edit | variation | Image operation. |
channel_row_id | string | Published route-row ID. |
status | string | Usage record status. |
Response
JSON endpoints use the standard response envelope. HTTP status represents the request outcome; business errors are not disguised as HTTP 200.
| HTTP | Meaning |
|---|---|
200 | Request succeeded |
400 | Invalid business parameter or filter |
401 | Missing or invalid API key |
403 | API key disabled or access forbidden |
422 | Request-structure validation failed |
500 | Internal service error |
Complete success example (optional fields vary by state)
{
"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"
}Important boundaries
- This endpoint is scoped to the current API key, not the account-wide console session view.