Credits & Usage
Get My Credits
See Current User — Get My Credits.
Organization Usage Statistics
See Organizations — Usage Statistics.
Admin: Query Credits
GET /v1/admin/credits?org_id={org_id}Requires platform_admin permission.
Response
{
"org_id": "...",
"balance": 5000,
"transactions": [...]
}Admin: Adjust Credits
POST /v1/admin/credits/adjustRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
org_id | string | Yes | Target Organization ID |
amount | int64 | Yes | Adjustment amount (positive to add, negative to subtract) |
note | string | No | Remark |
Response
{
"org_id": "...",
"balance": 5100
}Admin: Bulk Adjust Credits (All Organizations)
POST /v1/admin/credits/bulk-adjustRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
amount | int64 | Yes | Adjustment amount |
note | string | No | Remark |
Response
{ "affected": 42 }Admin: Reset All Organization Credits
POST /v1/admin/credits/reset-allRequest Body
| Field | Type |
|---|---|
note | string |
Response
{ "affected": 42 }Admin: Platform Usage Statistics
By Day
GET /v1/admin/usage/daily?start=YYYY-MM-DD&end=YYYY-MM-DDMonthly Summary
GET /v1/admin/usage/summary?year=2024&month=1By Model
GET /v1/admin/usage/by-model?year=2024&month=1