# Pricing, limits, and billing

Use this page as the authoritative reference for every plan number: included
usage, rate limits, overage pricing, reset behavior, and billing states. For
plan positioning and what each tier is for, see [Pricing](/docs/pricing.md).

## Plans

| Plan | Price | Seats | Hosted storage | Projects | Runs | Metric points / month | API requests / month |
| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| Free | $0 / workspace / month | 2 | 2 GiB | 2 | 100 | 1M | 500k |
| Pro | $199 / workspace / month | 3 | 1 TiB | 100 | 100k | 250M | 25M |
| Premium | $699 / workspace / month | 10 | 5 TiB | 500 | 1M | 2B | 150M |

Included seats apply to organization workspaces. Personal workspaces stay
single-owner; create a team organization workspace to use invitations and the
included seat pool.

Premium can also use customer-owned self-hosted GCP ClickHouse (BYOC) for teams
that need tenant data routed to their own deployment. Customer-owned ClickHouse
bytes are not counted as InstantML-hosted storage; only artifact bytes stored by
InstantML are counted.

## Overage

InstantML does not bill tracked training hours in v1.

| Usage type | Free | Pro | Premium |
| --- | --- | --- | --- |
| Hosted storage | Blocked at included pool | $0.03 / GiB-month overage | $0.03 / GiB-month overage |
| API requests | Blocked at 500k / month | $2 / 1M requests overage | $1 / 1M requests overage |

Paid storage overage is based on current-month high-water retained hosted
storage over the included pool. API request overage is metered after the
included monthly request allowance.

Paid storage overage is reportable/metered at `$0.03 / GiB-month`, but
artifact-storage and import writes can still be blocked at plan guardrails until
usage, plan, or custom terms change.

Project, run, and metric-point limits are write guardrails, not billable
meters. New writes can be blocked until usage, plan, or custom terms are
adjusted.

Extra seats are available through billing at $99 per seat/month.

## API rate limits

Short-window API rate limits protect the hosted API and ClickHouse data planes.
They apply in addition to monthly API request allowances.

| Plan | General API rate | Ingest API rate |
| --- | ---: | ---: |
| Free | 5 req/sec, burst 30 | 2 req/sec, burst 10 |
| Pro | 50 req/sec, burst 250 | 25 req/sec, burst 125 |
| Premium | 200 req/sec, burst 1000 | 100 req/sec, burst 500 |

Short-window `429` responses include `X-InstantML-RateLimit-Scope: second`,
`Retry-After`, `RateLimit-Limit`, `RateLimit-Remaining`, and
`RateLimit-Reset`.

Monthly API quota `429` responses include
`X-InstantML-RateLimit-Scope: monthly` and reset at the next UTC calendar
month. The Python SDK retries bounded short-window `429` responses and does not
retry monthly quota failures.

## Reset behavior

| Counter | Reset behavior |
| --- | --- |
| Metric points | Current UTC calendar month |
| API requests | Current UTC calendar month |
| Projects | Retained resource |
| Runs | Retained resource |
| Seats | Retained resource |
| Hosted storage | Retained resource with monthly high-water overage reporting |
| Artifacts | Visibility-only retained count |
| API keys | Retained resource |

Settings shows the current usage period, monthly reset date, API request usage,
plan rate limits, storage usage, seats, projects, runs, artifacts, and API-key
counts.

## Check usage from automation

Read the same counters shown in Settings with an unrestricted org API key that
has `usage:read`:

```bash
curl https://api.instantml.ai/api/usage \
  -H "Authorization: Bearer $INSTANTML_API_KEY"
```

The response includes the active plan catalog, current plan, limits, monthly
reset window, metric-point usage, API request usage, retained storage, artifact
counts, API-key counts, and billable overage fields.

## Billing

Paid signup and plan changes use Stripe Checkout or Stripe Billing flows. Paid
subscriptions include the base plan item plus metered overage items for hosted
storage and API requests.

When an organization is pending payment or payment-failed, product write routes
can return `payment_required`. Reads remain available unless the account state
requires operator intervention.

## Next steps

- [Pricing overview](/docs/pricing.md)
- [Export, usage, and limits](/docs/guides/export-usage-limits.md)
- [Auth, billing, and storage](/docs/guides/auth-billing-storage.md)
- [Errors, pagination, and limits](/docs/api/errors-and-limits.md)

## Agent navigation

- [Docs index](/llms.txt)
- [Full docs bundle](/llms-full.txt)

### Get Started

- [Overview](/docs/index.md)
- [Quickstart](/docs/quickstart.md)
- [Core Concepts](/docs/concepts/core-concepts.md)
- [Pricing](/docs/pricing.md)
- [Benchmarks](/docs/benchmarks.md)
- [Examples](/docs/guides/examples.md)
- [Troubleshooting](/docs/troubleshooting.md)

### SDK

- [Installation Auth](/docs/sdk/installation-auth.md)
- [Logging](/docs/sdk/logging.md)
- [Tracing](/docs/sdk/tracing.md)
- [Metrics Steps](/docs/sdk/metrics-steps.md)
- [Config Tags Notes](/docs/sdk/config-tags-notes.md)
- [Artifacts Checkpoints](/docs/sdk/artifacts-checkpoints.md)
- [Rich Objects](/docs/sdk/rich-objects.md)
- [Distributed Training](/docs/sdk/distributed-training.md)
- [Console System Integrations](/docs/sdk/console-system-integrations.md)
- [Reliability](/docs/sdk/reliability.md)
- [Cli Login](/docs/sdk/cli-login.md)
- [Querying Data](/docs/sdk/querying-data.md)
- [Agent Mcp](/docs/sdk/agent-mcp.md)
- [Examples Patterns](/docs/sdk/examples-patterns.md)

### Integrations

- [Overview](/docs/integrations/overview.md)
- [Pytorch Lightning](/docs/integrations/pytorch-lightning.md)
- [Huggingface Transformers](/docs/integrations/huggingface-transformers.md)
- [Keras](/docs/integrations/keras.md)
- [Wandb](/docs/integrations/wandb.md)

### Dashboard

- [Tour](/docs/dashboard/tour.md)
- [Organizations Workspaces](/docs/dashboard/organizations-workspaces.md)
- [Runs Workspace](/docs/dashboard/runs-workspace.md)
- [Metrics Charts](/docs/dashboard/metrics-charts.md)
- [Run Detail](/docs/dashboard/run-detail.md)
- [Traces](/docs/dashboard/traces.md)
- [Compare Runs](/docs/dashboard/compare-runs.md)
- [Research Dashboards](/docs/dashboard/research-dashboards.md)
- [Artifacts Files](/docs/dashboard/artifacts-files.md)
- [Run Health](/docs/dashboard/alerts.md)
- [Datasets](/docs/dashboard/datasets.md)
- [Checkpoints](/docs/dashboard/checkpoints.md)
- [Reports](/docs/dashboard/reports.md)
- [Settings Api Keys](/docs/dashboard/settings-api-keys.md)
- [Api Tab](/docs/dashboard/api-tab.md)
- [Onboarding Team Billing](/docs/dashboard/onboarding-team-billing.md)

### Data

- [Imports](/docs/guides/imports.md)
- [W&B alternative](/docs/guides/wandb-alternative.md)
- [InstantML vs MLflow](/docs/guides/instantml-vs-mlflow.md)
- [W&B import guide](/docs/guides/wandb-import-guide.md)
- [W&B and Neptune imports](/docs/guides/wandb-neptune-imports.md)
- [Export Usage Limits](/docs/guides/export-usage-limits.md)
- [Pricing Limits Billing](/docs/guides/pricing-limits-billing.md) (current page)
- [Auth Billing Storage](/docs/guides/auth-billing-storage.md)
- [Customer Owned Clickhouse](/docs/guides/customer-owned-clickhouse.md)
- [Observability](/docs/guides/observability.md)

### API

**Practical API guides**

- [Authentication](/docs/api/authentication.md)
- [Errors And Limits](/docs/api/errors-and-limits.md)
- [Health Observability](/docs/api/health-observability.md)
- [Projects Runs](/docs/api/projects-runs.md)
- [Metrics Series](/docs/api/metrics-series.md)
- [Attributes Objects](/docs/api/attributes-objects.md)
- [Artifacts](/docs/api/artifacts.md)
- [Reports](/docs/api/reports.md)
- [Iframe Embeds](/docs/api/iframe-embeds.md)
- [Import Export Usage](/docs/api/import-export-usage.md)
- [Dashboard Control State](/docs/api/dashboard-control-state.md)
**Architecture**

- [System Overview](/docs/architecture/system-overview.md)
- [Service Planes](/docs/architecture/service-planes.md)
- [Storage Model](/docs/architecture/storage-model.md)
- [Google Clickhouse](/docs/architecture/google-clickhouse.md)
- [Auth Tenancy](/docs/architecture/auth-tenancy.md)
- [Schema Reference](/docs/architecture/schema-reference.md)

### API Reference

- [API Reference](/docs/api-reference.md)