> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trystratos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits

> Check balance before spending it on generation.

`GET /v1/credits` — requires `credits:read`.

```json theme={null}
{
  "data": {
    "balance": 174,
    "extraCredits": 25,
    "monthlyCredits": 175,
    "usageUsed": 26,
    "renewsAt": "2026-09-01T00:00:00.000Z",
    "planTier": "starter",
    "unlimited": false,
    "dailyGenerationCeiling": 150,
    "costs": {
      "slideshow": 1,
      "illustratedImage": null,
      "characterImage": null,
      "characterVideo": null,
      "render": null
    }
  }
}
```

`costs` fields that are `null` mean the real cost varies by model and isn't exposed as a flat number yet (see `_lib/costs.ts` in the backend) — reported honestly as `null` rather than a made-up figure. `slideshow` is the only flat, reliable cost today, matching the only content type this API fully generates.

This is the exact same balance the Stratos AI dashboard shows — not a separate meter.