---
title: Billing and credits
description: Billing, subscription, and credit top-up behavior in the Sume dashboard.
---

Open [Billing & subscription](https://www.sume.com/dashboard/subscription) to
inspect plan status, available balance, and buy credits for Developer API usage.

(The product nav label is **Billing & subscription**. Older docs called this
surface “Credits”.)

What a generation costs is listed on the
[API pricing page](https://www.sume.com/pricing/api); subscription plans are on
[Pricing](https://www.sume.com/pricing).

## Current public reads

```text
GET /v1/balance
GET /v1/usage
```

These endpoints are read-only and scoped to the authenticated API key
workspace. Exact schemas: live
[OpenAPI](https://api.sume.com/reference/json).

## Manual top-up

The dashboard can initiate a Stripe-backed manual credit top-up when billing is
configured for the workspace. After checkout completes, the usage ledger can
show top-up activity and updated balance.

API clients should treat top-ups as dashboard operations. The public Developer
API currently exposes balance and usage reads, not a public top-up creation
endpoint.
