What it means
The API answers with HTTP 402 Payment Required and the application/problem+json document below when the condition is Reseller image generation limit reached. The document's type member is https://screenrig.ai/problems/reseller-generation-limit, the address of this page, and its code member is reseller_generation_limit.
What to do
The organization's reseller pays for its usage and has reached its monthly image generation limit; the limit resets on the 1st (UTC) and only screenRIG can raise it. Do not retry. Create the image another way and upload it (screenrig media upload FILE).
Should you retry?
The retryable member appears only on HTTP 5xx problems, so this one has none. Follow the steps under What to do before sending the request again.
Example response
Most routes answer with the error in the first entry of errors, and the document members instance and request_id beside it. The type, code, title and status of this problem type are fixed; detail varies per request, and hint is the registry default unless the handler sets a more specific one.
HTTP/1.1 402 Payment Required
Content-Type: application/problem+json
{
"errors": [
{
"status": 402,
"code": "reseller_generation_limit",
"type": "https://screenrig.ai/problems/reseller-generation-limit",
"title": "Reseller image generation limit reached",
"detail": "What went wrong in this request.",
"hint": "The organization's reseller pays for its usage and has reached its monthly image generation limit; the limit resets on the 1st (UTC) and only screenRIG can raise it. Do not retry. Create the image another way and upload it (screenrig media upload FILE)."
}
],
"instance": "INSTANCE",
"request_id": "REQUEST_ID",
"server_time": "2026-01-01T00:00:00Z"
}In the API contract
The OpenAPI contract describes this problem in these words:
Poll GET /api/operations/{id} until it is succeeded, when its result is {media_id, usage: {quality, credits, usd}} (MediaGenerationUsage), or failed, when its error is the problem. A refusal decided before any vendor work (payment_required, reseller_generation_limit, rate_limited, not_ready, invalid_request) still answers the POST.
Operations that name this problem
These operations name this problem in the API reference:
- Create Media Generation
POST /api/media/generations - Create Media Generation In Project
POST /api/projects/{project_id}/media/generations
Player action
This problem defines no Player action class. It belongs to a project, pairing or account flow that an agent or the dashboard drives.
Reference
| Code | reseller_generation_limit |
|---|---|
| HTTP status | 402 Payment Required |
| Type | https://screenrig.ai/problems/reseller-generation-limit |
| Player action | none |