Rate Limits
How many API requests per minute each Segmind plan allows, what counts against the limit, and what to do when you exceed it.
Segmind rate-limits API requests to keep the platform fair and reliable for everyone. The limit depends on your plan.
Limits by plan
| Plan | Rate limit |
|---|---|
| Flexible | 60 RPM |
| Pro | 120 RPM |
| Business | 500 RPM |
| Scale | 1000 RPM, pooled across your team |
| Enterprise | Custom |
RPM is requests per minute. On Scale, every member and every API key in the team draws from the same 1000 RPM allowance. See segmind.com/pricing for what each plan includes and how to upgrade. For a higher or reserved limit, contact sales about Enterprise.
What counts as a request
The limit counts submissions to model endpoints: POST /v1/{slug} and
POST /v2/{slug}. Each submission is one request, whatever the model or the
size of the job.
Polling a /v2 request's status_url or response_url does not count
against your plan's limit, so you can poll as often as the
polling guidance
recommends.
There is no per-account cap on concurrent in-flight generations. Long-running
video or LLM jobs do not block new submissions. If more /v2 jobs are submitted
than workers are free, they wait in QUEUED, and the queue_time field in the
result's metrics shows how long.
What happens over the limit
A submission over your limit is rejected with 429 Too Many Requests.
Nothing is queued and nothing is charged. Back off and retry: wait a few
seconds, then retry with exponential backoff.
Successful /v1 responses carry two headers you can use to pace yourself:
| Header | Meaning |
|---|---|
X-RATE-LIMIT-REMAINING | Requests left in the current one-minute window |
X-RATE-LIMIT-RESET-AT-UTC | When the current window resets, in UTC |
A /v2 job that has already been accepted is not lost if the upstream model
is busy: Segmind retries it automatically, and the job stays in QUEUED until
it runs.
If you regularly hit your limit, upgrade your plan at segmind.com/pricing. Error codes for other failure modes are listed in the API overview.
Webhooks
Receive real-time HTTP POST callbacks from Segmind when a PixelFlow run changes state, so you can react to node and graph events without polling.
Random Seed
Use the seed parameter to control randomness in Segmind model output. Pass -1 for a random seed, or any positive integer for reproducible results.