Common Error Codes

Overview

When something goes wrong, huhu.ai returns a structured error response with an HTTP status code, an error.code string, and a human-readable error.message. This guide covers the most common error codes and how to resolve them.

Client Errors (4xx)

400 Bad Request -- the request body is malformed or missing a required field. Double-check that all required parameters are present and correctly typed.

401 Unauthorized -- your API key is missing, expired, or invalid. Regenerate a new key from the dashboard if needed.

403 Forbidden -- your account does not have permission to access this resource. Verify your plan includes the feature you are trying to use.

429 Too Many Requests -- you have exceeded your rate limit. Wait for the Retry-After header value before sending the next request.

Server Errors (5xx)

500 Internal Server Error -- an unexpected error occurred on our side. These are rare and automatically logged. If the issue persists, contact support with the request_id from the response headers.

503 Service Unavailable -- the platform is undergoing maintenance or experiencing high load. Check the status page for updates and retry after a short delay.

Generation-Specific Errors

GARMENT_NOT_DETECTED -- the AI could not identify a garment in the uploaded image. Ensure the garment is clearly visible and the image is not too dark or blurry.

MODEL_POSE_UNSUPPORTED -- the model image pose is too extreme for the current algorithm. Use a front-facing or three-quarter pose for best results.

NSFW_CONTENT_BLOCKED -- the input or output was flagged by our safety filters. Review the image content and ensure it complies with our acceptable use policy.

Getting Further Help

If you encounter an error not listed here, open a support ticket from the dashboard and include the full error response and request_id. Our support team typically responds within 2 hours during business hours.