Credits
One credit per successful request. No subscriptions, no expiry. Check your balance and track usage from the dashboard.
Each successful API call deducts 1 credit. Failed requests (auth errors, validation errors, upstream failures) are not charged.
Every response includes your current balance:
{
"creditsUsed": 1,
"creditsRemaining": 99
}Check your balance
Copy your default key
New accounts get a default key automatically. Copy or reveal it from stophy.dev/dashboard, then store it in STOPHY_API_KEY.
export STOPHY_API_KEY="st_YOUR_API_KEY"Request your credits
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY! });
const { data } = await stophy.credits();
console.log(data?.credits);import os
from stophy import Stophy
stophy = Stophy(os.environ["STOPHY_API_KEY"])
print(stophy.credits()["data"]["credits"])curl https://api.stophy.dev/v1/credits \
-H "Authorization: Bearer $STOPHY_API_KEY"Insufficient credits
When your balance hits zero, requests return 402:
{
"success": false,
"code": "INSUFFICIENT_CREDITS",
"error": "Not enough credits."
}Top up from your dashboard. Buy what you need.
Track usage
| Endpoint | Description |
|---|---|
GET /v1/credits | Current balance |
GET /v1/usage | Daily consumption breakdown |
GET /v1/logs | Per-request history (30-day retention) |