Omni Docs
API Reference

Usage & Limits

Endpoints for querying monthly token consumption and credit balances.

GET /v1/usage

Retrieves detailed token consumption and request count statistics for the current billing cycle.

  • Scope Required: usage:read

Request

curl -sS "https://edge.omnistatic.com/v1/usage" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

{
  "month": "2026-08",
  "usage": {
    "uid": "usr_94a645d99c3a",
    "month": "2026-08",
    "totalTokens": 142500,
    "requestCount": 58
  }
}

GET /v1/credits

Returns remaining token entitlement balances.

  • Scope Required: usage:read

Request

curl -sS "https://edge.omnistatic.com/v1/credits" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

{
  "used": 142500,
  "limit": 1000000,
  "remaining": 857500,
  "month": "2026-08"
}

On this page