Errors - NSFW API

Errors use one stable JSON envelope and public messages are always in English.

{
  "error": {
    "message": "Insufficient balance",
    "type": "billing_error",
    "param": null,
    "code": "insufficient_balance"
  },
  "request_id": "req_..."
}

HTTP	Code	Meaning
400	`invalid_request`	The request body or parameters are invalid
400	`invalid_media_input`	Media is unavailable, expired, already used, or the wrong type
401	`invalid_api_key`	The key is missing, wrong, expired, or revoked
402	`insufficient_balance`	The price could not be reserved
403	`permission_denied`	The key lacks the scope or model access
404	`not_found`	The resource does not exist or belongs to another account
409	`idempotency_conflict`	The idempotency key was reused with a different body
409	`job_not_cancelable`	The job already went to the provider
413	`media_too_large`	The uploaded file exceeds its size limit
413	`storage_quota_exceeded`	The account is holding its maximum volume of inputs
429	`rate_limit_exceeded`	A rate or concurrency limit was hit
500	`internal_error`	An unexpected error on our side
502	`provider_error`	The upstream generator failed
503	`temporarily_unavailable`	A dependency is temporarily unavailable
504	`provider_timeout`	The upstream generator timed out

Retry 429, 500, 503, and 504 with backoff. Do not retry 400, 401, 402, 403, or 409 without changing the request or state. Always include request_id when contacting support.

Last modified on September 17, 2026