Format
data:image/...;base64, prefix.
Limits
Requests that exceed these limits are rejected with
INVALID_REQUEST and errors[].code = "PAYLOAD_TOO_LARGE". The field points either to the specific image field that exceeds 12 MB, or to body when the whole request exceeds 28 MB.
Multi-image endpoints (e.g. voter ID OCR with front + back, face match with face + front) share the 28 MB body cap — each image still has its own 12 MB cap.
Recommendations for best results
These are guidelines, not hard limits. Suboptimal images are still processed; results just become less reliable.
If extraction fails because the image is unreadable, you receive a clear result code (
IMAGE_UNREADABLE, NO_FACE_DETECTED, DOCUMENT_NOT_IDENTIFIED) so you can act on it.