Usage
The Usage service tracks resource consumption across workspaces — including word usage, image generation credits, and other metered features.
Concepts
What is tracked
The usage service tracks two types of resource consumption across your workspace:
Tokens — Every text generation request consumes tokens, counted across both the neuroflash UI and the API. Token usage accrues against both a monthly limit and a daily limit. The daily limit resets at midnight UTC; the monthly limit resets at the start of each billing cycle.
Images — Every image generated (text-to-image or image-to-image) consumes an image credit. Image usage follows the same monthly + daily limit structure as tokens.
API and UI share the same quotas
There is no separate quota for API usage. Calls made via the REST API, the MCP server, or any other integration draw from the same workspace quotas as usage through the neuroflash app. If your workspace reaches its token or image limit, both the UI and the API will be affected until the limit resets or the plan is upgraded.
Fair use policy
Each usage type has a fair use limit. Once this threshold is reached,
fairUseLimitReached is set to true in the quota response. Exceeding the fair use
limit may result in throttling depending on the subscription plan.
Quotas
Each workspace has quotas per usage type that track:
- Limit amount — Maximum allowed usage per billing cycle
- Daily limit amount — Maximum allowed usage per day
- Used amount — Total consumed in the current billing cycle
- Used amount daily — Consumed today
- Available amount — Remaining capacity in the current cycle
- Bonus amount — Additional credits beyond the plan base
- Spillover amount — Unused credits carried over from the previous cycle
Plan-level resource limits
In addition to token and image quotas, some resources are capped at the plan level:
| Resource | How to check |
|---|---|
| Brand voices | GET /brand-voice-service/v1/workspaces/{id}/brand-voice-limits |
| Target audiences | GET /audience-service/v1/workspaces/{id}/audience-limits |
These limits are independent of token/image quotas. Attempting to create a resource
beyond the plan limit returns 403 Forbidden with a descriptive error message.
Check current usage and limits before attempting to create new resources.
Endpoints
Base path: https://app.neuroflash.com/api/usage-service
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/workspaces/{id}/quotas | List workspace quotas |
POST | /v1/workspaces/{id}/usages | Record a usage event |
GET | /v1/usage-types | List all usage types |