Errors

Every error has the same shape, and the request_id is what to quote to support.

error

{
  "code": "quota_exceeded",
  "message": "The verification quota for this billing period is used up.",
  "request_id": "req_01m...",
  "details": { "quota": 20000 }
}

HTTP	code	Meaning
400	invalid_image_count, identity_required	The request is wrong
401	unauthorized	Missing or invalid key or token
403	insufficient_scope, account_inactive	Valid key, not allowed
404	not_found	Absent, or belongs to someone else
409	session_already_used, identity_exists, too_many_frames	Conflicts with current state
410	session_expired	The session has ended
413, 415	image_too_large, unsupported_media_type	The file was refused
422	validation_error, corrupt_image, too_few_good_images	Valid shape, unusable content
429	rate_limited, quota_exceeded, identity_limit_reached	Slow down, or a limit was reached
503	overloaded, engine_unavailable, uploads_busy	Retry after the delay