API reference
Usage
Aggregated, net of refunds, for the paying account. Operation keys are <type>:<model> (dots become underscores), social:post, social:account and character:preset.
GET/v1/usage
Scope: readReturns 200
Credits and billable requests for one calendar month (UTC), split by operation and by key.
Query parameters
- monthstringdefault: current month
Month in
YYYY-MMformat.
Request
curl https://api.oriorai.com/v1/usage \
-H "Authorization: Bearer $ORIOR_API_KEY"const response = await fetch('https://api.oriorai.com/v1/usage', {
headers: {
Authorization: `Bearer ${process.env.ORIOR_API_KEY}`,
},
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.code}: ${data.error.message}`)import os
import requests
response = requests.get(
"https://api.oriorai.com/v1/usage",
headers={"Authorization": f"Bearer {os.environ['ORIOR_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
data = response.json()Response · 200
Response
{
"object": "usage",
"month": "2026-09",
"credits": 386,
"requests": 142,
"by_operation": {
"image:orior-image": 120,
"video:seedance-2_5": 230,
"social:post": 36
},
"by_key": {
"key_8Hq2Lw0Pz4Nc1Xy7": 386
}
}