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

# Credits and limits

> Credits, rate limits, and plan behavior shared by the Bloom API and MCP.

API and MCP usage is governed by two things: the request limit for an API key and the credits available to the selected workspace.

## Rate limits

Each API key can make **120 accepted requests before a 60-second reset**. REST and MCP requests made with the same key share this budget, including keys sent as either `x-api-key` or `Authorization: Bearer bloom_sk_...`. The limit is per API key, so another key has its own budget. OAuth access tokens do not use this limiter.

The 60-second reset period starts again after every accepted request. Rejected requests do not extend it. A rate-limited API-key request returns `429 Too Many Requests`; REST responses use code `TOO_MANY_REQUESTS`, while MCP responses use `rate_limit_exceeded`. When the limiter can calculate the remaining delay, both include a `Retry-After` header with that delay in seconds. Wait for that delay before retrying, or wait 60 seconds if the header is absent.

If your integration sustains higher volume than that or batches generations in spikes, [contact us](mailto:support@trybloom.ai) so we can raise the ceiling for your key.

## Credits

Every image generation consumes credits from your workspace's monthly allotment. Bloom currently generates **images only**. We're working on additional output formats (video, copy, and more), though we don't have a public timeline for those yet. Every available action (generate, edit, resize, variant, recreate, remove-background, vectorize) is priced against the same image credit table below.

| Image size | Cost      |
| ---------- | --------- |
| `2K`       | 1 credit  |
| `4K`       | 2 credits |

Variants multiply the cost — `variantCount: 3` at `4K` costs 6 credits. Check your current balance in your [account dashboard](https://www.trybloom.ai/billing) or via [`GET /credits`](/api-reference/account/get-credit-balance). When you run out, generation requests return `HTTP 402` until you top up or your plan refreshes — the error response includes a deep link to the pricing page in `data.action_url`.

If you belong to a team, every workspace has its own balance. Pass `workspaceId` to [`GET /credits`](/api-reference/account/get-credit-balance) to read the balance on a specific workspace — your personal one (the default) or any team workspace you can access. Use [`GET /workspaces`](/api-reference/account/list-workspaces) to look up every workspace ID you can see.

### What does `402` mean?

A `402` response can mean one of two things — branch on `code`, not on the HTTP status:

* `INSUFFICIENT_CREDITS` — the workspace's balance is zero. Top up or wait for the plan to refresh.
* `PAYMENT_REQUIRED` — the **subscription is paused** (typically a failed or pending payment).

Both responses include a `data.action_url` that lets the caller purchase credits, make a payment to resume their subscription, or upgrade their plan.

### Top-ups

Need more credits without changing plans? Buy a one-off top-up of **20–200 credits**. Top-up credits never expire.

## Plan tiers

| Plan      | Monthly credits |
| --------- | --------------- |
| **Plus**  | 50              |
| **Pro**   | 100             |
| **Max**   | 200             |
| **Scale** | 300–8,000       |

See [pricing](https://www.trybloom.ai/#pricing) for plan prices, annual discounts, and the full breakdown.

Bloom does not offer a typical free plan — all full plans are paid. New accounts receive **10 free credits** on account creation to try the API. API and MCP access are included in every paid plan.

### When credits renew

Plan credits refresh **monthly on your billing anniversary** — the day of the month you started (or last renewed) your subscription. Unused plan credits do not roll over. [Top-up credits](#top-ups) are separate and never expire.

You can check your current balance any time from your [account dashboard](https://www.trybloom.ai/billing).

## Need more credits?

If you need high concurrency, batches of thousands of generations, or white-label use, contact [support@trybloom.ai](mailto:support@trybloom.ai). We'll work out a custom plan for you.