Error Codes

Understanding API error responses

Error Codes
Understanding API error responses
400invalid_request

The request parameters are invalid or malformed.

Solution: Check your request body and ensure all required fields are present with valid values.

401unauthorized

Invalid or missing API key.

Solution: Ensure you're including a valid API key in the Authorization header.

402insufficient_credits

Not enough credits in your API wallet.

Solution: Purchase more credits or wait for your credits to refill.

404not_found

The requested resource (task, webhook, etc.) was not found.

Solution: Verify the resource ID is correct.

429rate_limited

Too many requests in a short period.

Solution: Implement exponential backoff and respect rate limits.

500internal_error

Something went wrong on our end.

Solution: Retry the request after a short delay. If the issue persists, contact support.

Rate Limits
Default rate limits:
MetricLimit
Requests per minute60
Requests per day10,000
Concurrent tasks5
Nano Banana Pro API