Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.reactor.inc/llms.txt

Use this file to discover all available pages before exploring further.

Reactor enforces a small number of rate limits to ensure fair access to GPU resources. This page documents the known limits and the errors you can expect when they are exceeded.

Session quotas

QuotaDefaultScope
Concurrent sessions5Per account (shared across all API keys)
Sessions per minute (per model)50Per account, per model
Session max duration1 200 seconds (20 min)Per session
Need higher limits? All session quotas can be increased. Contact support@reactor.inc or reach out on Discord. You can view your current quotas in the Dashboard under Account Settings.

Concurrent sessions

Each account can run up to 5 sessions at the same time, pooled across every API key on the account. This limit applies regardless of which model you connect to.
Sessions in the connecting or waiting states count toward the concurrent limit because a GPU has been requested on your behalf. Disconnect sessions you no longer need to free up slots.

Sessions per minute

You can create up to 50 sessions per minute per model. This limit prevents burst abuse while still allowing rapid iteration during development. If you exceed it, back off briefly and retry.

Session max duration

A single session can run for up to 1 200 seconds (20 minutes) before it is automatically terminated. Plan your application logic around this window. For longer workflows, start a new session when the current one approaches the limit.
Listen for session lifecycle events in the SDK so your app can gracefully handle an approaching timeout. See Sessions for details.

Token TTL

Tokens issued by POST /tokens are valid for at most 6 hours. You can shorten the lifetime with the expires_after parameter (in seconds), but you cannot extend it beyond the 6-hour ceiling. Values at or above 21 600 are silently clamped. Always read expires_at on the response to confirm the actual expiry. See Authentication for the full token-issuance flow.

File uploads

When you upload files to a session, Reactor returns presigned URLs with limited lifetimes:
URL typeLifetimeNotes
Upload URL15 minutesPUT your file within this window or re-request
Download URL5 minutesGET URLs for retrieving uploaded assets
If a presigned URL expires before you use it, request a new one. See File Uploads for the full workflow.

Behavior when limits are hit

ScenarioHTTP statusWhat to do
Too many concurrent sessions429 Too Many RequestsDisconnect an existing session, then retry.
Sessions-per-minute exceeded429 Too Many RequestsBack off briefly and retry.
Session max duration reachedSession terminatedStart a new session. The SDK will fire a disconnect/error event.
Out of credits / billing cap402 Payment RequiredTop up or upgrade your plan from the Dashboard.
Token expired401 UnauthorizedIssue a new token via POST /tokens. See Authentication.

Next steps

Pricing & Billing

Understand how sessions are billed and how to minimize cost.

FAQ

Common questions about sessions, tokens, and troubleshooting.