Docs · API · Usage
Usage & credits.
One endpoint answers both billing questions: what is my balance, and where did the credits go.
Get usage#
GET
/v1/usage| Query param | Type | Description | |
|---|---|---|---|
| days | integer | default: 30 | Reporting window in days, capped at 90. |
curl "https://scribe.whizztech.ai/v1/usage?days=7" \
-H "Authorization: Bearer $SCRIBE_KEY"{
"object": "usage",
"days": 7,
"credit_balance": 118,
"daily": [
{
"day": "2026-07-01",
"credits": 20,
"requests": 2,
"tokens_in": 184220,
"tokens_out": 21458
},
{
"day": "2026-07-03",
"credits": 31,
"requests": 1,
"tokens_in": 402917,
"tokens_out": 38112
}
]
}| Field | Type | Description |
|---|---|---|
| object | "usage" | Resource type. |
| days | integer | The window actually applied. |
| credit_balance | integer | Current org balance, computed live from the ledger. |
| daily | row[] | One row per day with activity (days without usage are omitted), ordered oldest first. |
| daily[].day | string | Date, YYYY-MM-DD. |
| daily[].credits | integer | Credits consumed that day. |
| daily[].requests | integer | Billable operations that day (one per finished generation job). |
| daily[].tokens_in / tokens_out | integer | Raw LLM token throughput behind your jobs — useful for spotting unusually heavy topics. |
Credit price list#
| Field | Type | Description |
|---|---|---|
| article_standard | 10 credits | Standard-mode article. |
| article_deep_research | 25 credits | Deep-research-mode article (replaces the base 10). |
| hero_image | 3 credits | Added when image: true. |
| derivatives_bundle | 3 credits | Flat add-on for any non-empty derivatives selection. |
| extra_language | 5 credits | Added when language is not "en". |
Worked example: deep_research + image + derivatives in German = 25 + 3 + 3 + 5 = 36 credits. Brand-profile creation, source ingestion, listing, and reading are all free.
How accounting works#
- Ledger-based. Every grant is a positive ledger entry, every debit a negative one; your balance is the sum. Nothing is ever silently adjusted — each entry has a description and, for debits, the job ID.
- Debit up front.Credits are charged when the job is created. If the balance can't cover it, the request fails with
402 insufficient_creditsand no job is created. - Automatic refunds. A failed job refunds its full charge before the
job.failedwebhook fires. You only pay for articles that complete. - Idempotent replays are free. Re-submitting with the same
Idempotency-Keyreturns the existing job without a second debit.
Plan grants#
| Field | Type | Description |
|---|---|---|
| Trial | 30 credits once | Free. One brand profile, one seat. |
| Starter | 150 / month | $29. One brand profile, one seat. |
| Growth | 500 / month | $79. Three brand profiles, three seats. |
| Scale | 1,500 / month | $199. Ten brand profiles, ten seats. |
| Enterprise | custom | Custom volume and limits — support@whizztech.ai. |