# Plans

> Free, Pay as you go and Enterprise: what each plan includes and the errors it can return.

Every organization is on one of three plans: Free, Pay as you go or Enterprise. The plan decides which models you can call, the fee on credit purchases, whether you can use your own provider keys, how many projects you can have, and which request controls are available. Token prices don’t change between plans: every request is charged at the provider’s list price.

## Comparison

| Feature | Free | Pay as you go | Enterprise |
| --- | --- | --- | --- |
| Models | Free models only | Every model | Every model |
| Platform fee | None | 5.5% ($0.80 min) | Custom |
| Bring your own keys | No | $25,000 a month free, then 4% | Custom allowance |
| Projects | 5 | 1,000 | Custom |
| Rate limits | 20 a minute, 50 a day | Provider limits apply | Provider limits apply |
| Spending limits on API keys | No | Yes | Yes |
| Fallbacks and provider preferences | No | Yes | Yes |
| Activity logs | Yes | Yes | Yes |
| Free models | 20 a minute, 50 a day | 20 a minute, 1,000 a day | 20 a minute, 1,000 a day |
| Support | Community | Email | Dedicated |

The [pricing page](https://clonvo.com/pricing.md#examples) has worked examples of purchase and bring-your-own-key fees.

## Free

New organizations start on Free. It’s for trying Clonvo on [free models](https://clonvo.com/docs/free-models.md) (ids ending in `:free`).

-   Only free models are available. A request to a paid model fails with `402`: the code is `insufficient_credits`, or `byok_requires_paid_plan` if your organization has added provider keys or the model [only runs with your own key](https://clonvo.com/docs/byok.md#providers-that-need-your-own-key).
-   [Fallbacks and provider preferences](https://clonvo.com/docs/fallbacks.md) aren’t available. A request that includes `models` or `provider` fails with `402` and the code `plan_feature_unavailable`.
-   API keys can’t have [spending limits](https://clonvo.com/docs/authentication.md#spending-limits). Free models cost nothing, so there’s nothing to limit.
-   Up to 5 projects. Archived projects don’t count.
-   Community support.

## Pay as you go

Buying credits of any amount moves your organization to Pay as you go. There’s nothing else to switch on and no subscription. If every purchase is refunded, the organization goes back to Free.

-   Every model in the [catalogue](https://clonvo.com/models.md), at list price.
-   A 5.5% fee on each credit purchase, $0.80 minimum. See [Credits and billing](https://clonvo.com/docs/credits.md).
-   [Your own provider keys](https://clonvo.com/docs/byok.md): the first $25,000 of list-price usage each month has no fee, then 4%.
-   Spending limits on API keys, [fallback models](https://clonvo.com/docs/fallbacks.md) and provider preferences.
-   No Clonvo rate limits beyond an abuse ceiling of 10,000 requests a minute per API key. The providers’ own limits still apply. See [Rate limits](https://clonvo.com/docs/rate-limits.md).
-   Up to 1,000 projects.
-   Email support.

## Enterprise

Enterprise terms are agreed with each customer: the purchase fee, the bring-your-own-key allowance and the project limit are set by Clonvo for your organization, and you get dedicated support. Email [sales@clonvo.com](mailto:sales@clonvo.com) to talk it through.

## On every plan

-   Requests are charged at the provider’s list price, with no markup on tokens.
-   Every request appears in your activity, with its cost.
-   Free models allow 20 requests a minute and 50 a day per organization, or 1,000 a day once it has bought $10 of credits in total.
-   Failed requests aren’t charged.

## Checking your plan

`GET /v1/key` returns your organization’s plan in `plan`, and `is_free_tier` is `true` while the organization is on Free. See [Other endpoints](https://clonvo.com/docs/other-endpoints.md#get-v1-key).

## Plan errors

| Status | Code | When, and what to do |
| --- | --- | --- |
| `402` | `insufficient_credits` | A paid model was requested without enough credits. On Free, buy credits to move to Pay as you go. |
| `402` | `byok_requires_paid_plan` | A paid model was requested on Free while your organization has provider keys, or the model only runs with your own key. Your own keys work from Pay as you go up: buy credits first. |
| `402` | `plan_feature_unavailable` | The request used `models` or `provider` on Free. Remove them, or buy credits to move to Pay as you go. |
| `402` | `project_limit_reached` | Creating or restoring a project would go over your plan’s limit. Archive a project you don’t use. On Free, buying credits moves you to Pay as you go, which allows 1,000. On Pay as you go, email [sales@clonvo.com](mailto:sales@clonvo.com) about Enterprise. |

See [Errors](https://clonvo.com/docs/errors.md) for every status code.