Queries the usage of an AI application.
Try it now
Test
RAM authorization
Request syntax
GET HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ApplicationId |
string |
Yes |
The Hermes application ID. |
pa-123456 |
| Days |
integer |
No |
The number of recent days to query. Valid values: 1 to 365. Default value: 30. |
30 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
F45FFACC-1234-5678-90AB-1234567890AB |
| Message |
string |
The response message. |
successful |
| Code |
integer |
The response status code. |
200 |
| ApplicationId |
string |
The Hermes application ID. |
pa-123456 |
| Days |
integer |
The number of days covered by this statistical period. |
30 |
| Summary |
object |
The aggregated usage within the query period. |
|
| Sessions |
integer |
The number of sessions. |
120 |
| APICalls |
integer |
The number of model API calls. |
480 |
| InputTokens |
integer |
The number of input tokens. |
120000 |
| OutputTokens |
integer |
The number of output tokens. |
36000 |
| CacheReadTokens |
integer |
The number of tokens served from cache hits. |
18000 |
| ReasoningTokens |
integer |
The number of reasoning tokens. |
6000 |
| DailyUsage |
array<object> |
The usage statistics grouped by UTC date. |
|
|
object |
The usage for a single day. |
||
| Date |
string |
The UTC date. |
2026-07-24 |
| Sessions |
integer |
The number of sessions for the day. |
12 |
| APICalls |
integer |
The number of model API calls for the day. |
48 |
| InputTokens |
integer |
The number of input tokens for the day. |
12000 |
| OutputTokens |
integer |
The number of output tokens for the day. |
3600 |
| CacheReadTokens |
integer |
The number of tokens served from cache hits for the day. |
1800 |
| ReasoningTokens |
integer |
The number of reasoning tokens for the day. |
600 |
| ModelUsage |
array<object> |
The usage statistics grouped by model. |
|
|
object |
The usage for a single model. |
||
| Model |
string |
The model identifier. |
qwen3-max |
| Provider |
string |
The model provider. |
bailian |
| Sessions |
integer |
The number of sessions that used this model. |
80 |
| APICalls |
integer |
The number of API calls for this model. |
320 |
| InputTokens |
integer |
The number of input tokens consumed by this model. |
80000 |
| OutputTokens |
integer |
The number of output tokens generated by this model. |
24000 |
| CacheReadTokens |
integer |
The number of tokens served from cache hits for this model. |
12000 |
| ReasoningTokens |
integer |
The number of reasoning tokens generated by this model. |
4000 |
| SkillUsage |
object |
The aggregated statistics of skill activities. |
|
| TotalLoads |
integer |
The number of times skills were loaded or viewed. |
50 |
| TotalEdits |
integer |
The number of times skills were edited or managed. |
10 |
| TotalActions |
integer |
The total number of skill-related operations. |
60 |
| DistinctSkills |
integer |
The number of distinct skills that have activity records. |
8 |
| SessionSummary |
object |
The current session runtime and storage statistics. |
|
| ActiveSessions |
integer |
The number of currently active sessions. |
5 |
| StoredSessions |
integer |
The total number of sessions in session storage. |
120 |
Examples
Success response
JSON format
{
"RequestId": "F45FFACC-1234-5678-90AB-1234567890AB",
"Message": "successful",
"Code": 200,
"ApplicationId": "pa-123456",
"Days": 30,
"Summary": {
"Sessions": 120,
"APICalls": 480,
"InputTokens": 120000,
"OutputTokens": 36000,
"CacheReadTokens": 18000,
"ReasoningTokens": 6000
},
"DailyUsage": [
{
"Date": "2026-07-24",
"Sessions": 12,
"APICalls": 48,
"InputTokens": 12000,
"OutputTokens": 3600,
"CacheReadTokens": 1800,
"ReasoningTokens": 600
}
],
"ModelUsage": [
{
"Model": "qwen3-max",
"Provider": "bailian",
"Sessions": 80,
"APICalls": 320,
"InputTokens": 80000,
"OutputTokens": 24000,
"CacheReadTokens": 12000,
"ReasoningTokens": 4000
}
],
"SkillUsage": {
"TotalLoads": 50,
"TotalEdits": 10,
"TotalActions": 60,
"DistinctSkills": 8
},
"SessionSummary": {
"ActiveSessions": 5,
"StoredSessions": 120
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.