Overview
Stophy uses credits for usage billing. Credit-consuming endpoints deduct from your balance. Your plan defines monthly credits and limits.Credits
Credits are the unit of API usage. Plan credits reset on your billing cycle.Credit costs per endpoint
| Endpoint | Credit Cost | Notes |
|---|---|---|
| transcript | 1 credit | Extract plain text and timestamped transcript segments. |
| details | 1 credit | Fetch metadata, chapters, channel info, and related videos. |
| comments | 1 credit | Fetch comments with sortBy and pagination tokens. |
Credit costs can evolve over time. Use the dashboard for the latest numbers.
When credits are charged
Credits are charged when a credit-consuming request is processed. Polling activity or checking credits does not consume credits.Track your usage
You can monitor usage in two ways:- Dashboard: https://stophy.dev/playground
- API:
GET /v1/account/creditsandGET /v1/account/activity
Plans
Stophy provides plan-based billing with monthly credit limits.Available plans
| Plan | Monthly Credits | Notes |
|---|---|---|
| Free | Varies | Good for testing and first integrations. |
| Pro | Varies | Good for production products and teams. |
| Scale | Varies | High-volume use with custom limits. |
Auto-recharge
Enable auto-recharge if your workload is bursty and can exceed plan credits.- recharge packs are added automatically when your balance is low
- you can enable or disable auto-recharge at any time
- recharge credits can have different expiry behavior than monthly plan credits
Coupons
Coupons may include:- subscription discounts
- bonus credits
Billing cycle
- Monthly plans: credits reset on your monthly renewal date
- Yearly plans: billed yearly, credits still reset monthly
- unused plan credits may not roll over unless explicitly stated by your plan
Plan changes
- Upgrades usually take effect immediately with prorated billing
- Downgrades usually apply at the next renewal date
What happens when you run out of credits
If your credit balance is exhausted and auto-recharge is disabled, requests to credit-consuming endpoints can returnHTTP 402.
To resume usage:
- enable auto-recharge
- upgrade your plan
- wait until credits reset at the next billing cycle
FAQs
Do unused credits roll over to the next month?
Do unused credits roll over to the next month?
Plan behavior depends on your active subscription. Check billing details in your dashboard for the exact rollover policy.
How do I check credits left?
How do I check credits left?
Use the dashboard, or call
GET /v1/account/credits.How do I track usage programmatically?
How do I track usage programmatically?
Call
GET /v1/account/activity and filter by endpoint and time window in your
own analytics layer.What does HTTP 402 mean?
What does HTTP 402 mean?
It means your account has insufficient credits for the requested operation.
Where do I apply coupon codes?
Where do I apply coupon codes?
Open billing settings in the dashboard. If a code is checkout-only, apply it when subscribing or changing plans.