Skip to main content
All error responses use this envelope: 
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Public message"
  },
  "request_id": "18b2ad5e-2a9e-4d3f-b9a8-9f2a1e0b1234"
}
Validation errors may also include error.details, an array of field-level validation messages. The same request id is also sent as the X-Request-Id response header. Include it when contacting support.

​
Common Error Codes

HTTPCodeTypical Cause
400VALIDATION_ERRORRequest payload failed validation
400INVALID_PERSONAPersona id is not a valid UUID
400INVALID_STYLEStyle id is not a valid UUID
400INVALID_AMOUNTAmount is invalid or negative
400CONTENT_POLICYRequest blocked by content policy
400CANNOT_DELETE_PROCESSINGAttempted to delete a persona or style while processing
400SUPPORT_IMAGE_NOT_SUPPORTEDSupport image is not available on the selected model
413IMAGE_TOO_LARGEInput image exceeds the 10 MB size limit
401MISSING_API_KEYMissing X-Api-Key header
401INVALID_API_KEY_FORMATAPI key does not start with pkz_
401INVALID_API_KEYAPI key is unknown
401API_KEY_INACTIVEAPI key is disabled
401API_KEY_DELETEDAPI key was deleted
402INSUFFICIENT_CREDITSAPI balance is too low for the requested operation, or Smart Balance is enabled but the configured top-up cannot cover this request
402SMART_BALANCE_PAYMENT_FAILEDSmart Balance is paused because the automatic top-up payment could not be processed
403API_ACCESS_NOT_ENABLEDAccount does not have API access
403ACCOUNT_SUSPENDEDAccount is suspended
404NOT_FOUNDRequested resource or route was not found
409NAME_RESERVEDPersona or style name is reserved
409NAME_ALREADY_EXISTSPersona or style name already in use
409CONFLICTRequest conflicts with existing state
422GENERATION_REJECTEDRequest could not be processed
499CANCELLEDGeneration was cancelled
500GENERATION_FAILEDGeneration request failed
400INVALID_IMAGEImage URL/body is invalid or not an accessible image
500INTERNAL_ERRORUnexpected server error
503SERVICE_UNDER_MAINTENANCEService maintenance window is active
504GENERATION_TIMEOUTGeneration request exceeded timeout
504SCORING_TIMEOUTThumbnail scoring exceeded timeout
504TITLE_TIMEOUTTitle generation exceeded timeout
429TOO_MANY_REQUESTSRate limit exceeded
Error codes may expand over time. Use code for programmatic handling and use message for a safe public summary.