Credits on the API

One wallet. One credit is one dollar. GET is free. Only generate spends. The product guide is Understanding credits.

01What a call costs

Operation	Credits	Route
Article generate	1.5	POST /api/v1/articles/generate
Social generate	0.6 per platform	POST /api/v1/social/generate
Publish or schedule	0	POST /api/v1/social/publish
Every GET	0	lists, detail, status, credits, usage

Two platforms cost 1.2. All 13 live channels in one call cost 7.8. You still get one content_id.

02Read the wallet

curl https://www.brainpercent.app/api/v1/user/credits \
  -H "Authorization: Bearer bp_your_key"

200Response

{
  "success": true,
  "data": {
    "available_credits": 52,
    "subscription_credits": 60,
    "purchased_credits": 0,
    "credits_used_this_month": 8,
    "plan": "Creator",
    "current_period_end": "2026-03-01T00:00:00Z"
  }
}

Field	Meaning
available_credits	The number to check. Whole balance.
subscription_credits	Plan grant. Spent first.
purchased_credits	Top-ups. Never expire. Spent second.
plan	Internal name: Creator, Professional, Business, Agency, or Free.

03402

Do not retry. Top up or shrink the platform list, then send a new request.

402Response

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "This operation requires 2.4 credits but your balance is 1.2"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T12:00:00Z"
  }
}