NSFW API Error Codes & Troubleshooting Guide
Common HTTP status codes and error responses returned by the NSFW API with reasons and fixes.
Try NSFW Demo →Authentication Errors
401 - AUTH_ERROR
Authentication failed
Reason: Invalid API key, signature mismatch, or auth fields sent after file
Fix: Ensure correct apiKey, signature, and send auth fields BEFORE file
Authentication failed
Reason: Invalid API key, signature mismatch, or auth fields sent after file
Fix: Ensure correct apiKey, signature, and send auth fields BEFORE file
Validation Errors
400 - INVALID_INPUT
Invalid request format
Cases:
• Missing signature
• Wrong field name (use image or images )
• Multiple files in single request
• No file uploaded
• More than 5 files in batch
Fix: Follow API contract strictly
Invalid request format
Cases:
• Missing signature
• Wrong field name (use image or images )
• Multiple files in single request
• No file uploaded
• More than 5 files in batch
Fix: Follow API contract strictly
Rate Limiting
429 - RATE_LIMIT_EXCEEDED
Too many requests
Reason: RPM limit reached
Fix: Retry later or upgrade plan
Too many requests
Reason: RPM limit reached
Fix: Retry later or upgrade plan
File Errors
413 - FILE_TOO_LARGE
Image exceeds allowed size
Limit: 200KB per image
Fix: Compress or resize image before upload
Image exceeds allowed size
Limit: 200KB per image
Fix: Compress or resize image before upload
Server Errors
503 - SERVICE_UNAVAILABLE
Service under maintenance
Fix: Retry after some time
Service under maintenance
Fix: Retry after some time
500 - SERVER_ERROR
Unexpected failure
Fix: Retry or contact support if persistent
Unexpected failure
Fix: Retry or contact support if persistent
Most errors can be avoided by validating auth fields, file size (≤200KB), and request structure before sending.