Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rimp.mintlify.app/llms.txt

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

All errors return a consistent JSON envelope and include an X-Request-Id header so you can quote it to support. 
{
  "error": {
    "type": "insufficient_credits",
    "code": "insufficient_credits",
    "message": "Wallet balance (120) below requested reservation (240).",
    "request_id": "req_abc123"
  }
}

​
Error types

TypeHTTPRetry?Meaning
invalid_request400NoBody or query failed schema validation. Fix and retry.
authentication401NoMissing or invalid bearer token.
authorization403NoToken doesn’t have the scope or IP isn’t allowed.
not_found404NoResource doesn’t exist or belongs to another org.
conflict409ConditionalIdempotency-Key reused with different body, or job not cancelable.
insufficient_credits402After top-upWallet below reservation.
rate_limited429Yes, with Retry-AfterPer-key RPM exceeded.
content_policy_blocked422NoPrompt or output blocked by moderation.
provider_unavailable502Yes (backoff)Upstream model is down. Try a different model or wait.
quota_exceeded429After top-upMonthly hard cap reached.
internal500Yes (backoff)Bug on our side. Include request_id when reporting.

​
Common error codes

invalid_body              — zod validation failed; check `param` field
empty_body                — POST with no JSON body
not_signed_in             — endpoint requires session cookie
not_cancelable            — generation is already succeeded/failed/canceled
idempotency_key_too_long  — keys must be ≤ 200 chars
idempotency_key_reuse     — same key + different body in 24h window
anomaly_paused            — org temporarily blocked by spending anomaly detector

​
Retry strategy

For provider_unavailable and internal, retry with exponential backoff: 
async function withRetry<T>(fn: () => Promise<T>, attempts = 4): Promise<T> {
  for (let i = 0; i < attempts; i++) {
    try {
      return await fn();
    } catch (err) {
      if (err.status === 429 || err.status === 502 || err.status === 500) {
        const ms = Math.min(30_000, 1_000 * 2 ** i + Math.random() * 500);
        await new Promise((r) => setTimeout(r, ms));
        continue;
      }
      throw err;
    }
  }
  throw new Error('Exhausted retries');
}
For rate_limited (429), honor the Retry-After header instead of exponential backoff.

​
Idempotency-Key replay

If a POST creates a generation and the connection drops, retry with the same Idempotency-Key. The original response is replayed (we send Idempotent-Replayed: true in the headers). No duplicate charge.