·Error Codes

Error Codes

All API errors follow a consistent structure. Check the error.code field for programmatic error handling.

400missing_fieldsBad Request

Required fields are missing from the request body.

400invalid_modelBad Request

The model field contains an invalid value.

401unauthorizedUnauthorized

Missing or malformed Authorization header.

401invalid_keyUnauthorized

The API key does not exist or has been deleted.

401key_revokedUnauthorized

The API key exists but has been revoked.

402insufficient_creditsPayment Required

The account does not have enough credits for this operation.

429rate_limit_exceededToo Many Requests

The key has exceeded the 100 requests/minute limit.

500generation_failedServer Error

The image generation failed on the upstream provider.

Handling errors in code

Error response shape

json

{
  "error": {
    "message": "Human readable error message",
    "code": "machine_readable_code"
  }
}

400 · missing_fields

json

{
  "error": {
    "message": "Missing required fields: model, prompt",
    "code": "missing_fields"
  }
}

400 · invalid_model

json

{
  "error": {
    "message": "Invalid model. Must be one of: nano-banana, nano-banana-2, nano-banana-pro",
    "code": "invalid_model"
  }
}

401 · unauthorized

json

{
  "error": {
    "message": "Missing or invalid Authorization header",
    "code": "unauthorized"
  }
}

401 · invalid_key

json

{
  "error": {
    "message": "Invalid API key",
    "code": "invalid_key"
  }
}

Error response shape

json

{
  "error": {
    "message": "Human readable error message",
    "code": "machine_readable_code"
  }
}

400 · missing_fields

json

{
  "error": {
    "message": "Missing required fields: model, prompt",
    "code": "missing_fields"
  }
}

400 · invalid_model

json

{
  "error": {
    "message": "Invalid model. Must be one of: nano-banana, nano-banana-2, nano-banana-pro",
    "code": "invalid_model"
  }
}

401 · unauthorized

json

{
  "error": {
    "message": "Missing or invalid Authorization header",
    "code": "unauthorized"
  }
}

401 · invalid_key

json

{
  "error": {
    "message": "Invalid API key",
    "code": "invalid_key"
  }
}