ContentHero bills generation in credits. Pricing is computed server-side per operation, based on the model, resolution, duration, and mode. The developer surface lets you read your balance and preview any spend before it happens.
Read your balance
Call get_balance. It returns your current credit balance.
contenthero account balance
curl https://app.contenthero.ai/api/v1/balance \
-H "Authorization: Bearer $CONTENTHERO_API_KEY"
Preview cost before you spend
Every spend can be previewed for free. The preflight takes the exact same parameters as the real generation, so the quoted price matches what you will be charged.
Pass getCost: true on any generate_* call. It returns the price and submits no job.
contenthero generate image --prompt "..." --model nano-banana-2 --cost
Always preview cost before a large or batched spend, and surface it to the user. This is a hard rule for agents.
Usage attribution
Spends made with an API key are attributed to that key, so you can see which integration consumed what. Per-key usage is visible in the API Keys view in the app.
Plans and limits
Some surfaces are plan-limited (for example, the brand knowledge base caps items per brand kit by tier). When you hit a cap, the response says so. Upgrade the plan in the app, or remove an item to make room. 
