Credits

How credits work

Every run consumes credits. The cost depends on the model used and the complexity of the prompt. Credits are deducted when a run is created — an estimated amount is reserved upfront, then adjusted when the run finishes.

Checking your balance

Use the credits endpoint to see how many credits you have left:

bash

curl "https://api.betterprompt.me/v1/me/credits" \
  -H "Authorization: Bearer $BETTERPROMPT_API_KEY"

json

{
  "status": "SUCCESS",
  "data": {
    "credits": 4250
  }
}

What happens when you run out

If your balance is too low to cover a run, the API returns a 402 PAYMENT_REQUIRED_ERROR. Top up your credits in your BetterPrompt account to continue.

Tracking usage

The tokens field in run responses tells you how many credits that specific run consumed. Use the List runs endpoint to review historical usage — each run includes its credits cost.

API reference

GET /v1/me/credits — Check credit balance
GET /v1/me — Account info
POST /v1/runs — Credits are consumed here

Credits ​

How credits work ​

Checking your balance ​

What happens when you run out ​