Skip to main content
POST
Analyze image for visual and textual safety concerns

Authorizations

Authorization
string
header
required

API key as Bearer token

Response

200 - application/json

Default Response

file_id
string
vision
object
text_analysis
object
overall_risk_score
number
overall_severity
enum<string>
Available options:
none,
low,
medium,
high,
critical
detected
boolean

A concern was observed at ANY severity, including monitor-only cases. For production branching prefer recommended_action.

confidence
number

Confidence in the overall verdict (0-1).

Routing key, weakest to strongest: none, monitor, flag_for_review, block, immediate_intervention. Derived from the stronger of the visual verdict and the OCR text verdict, so harmful text in a visually benign image still routes correctly. Safe to switch on.

Available options:
none,
monitor,
flag_for_review,
block,
immediate_intervention
action_detail
string

Human-readable expansion of recommended_action for a moderator UI. Free text: do not branch on it.

rationale
string

Why this verdict was reached. Built from category and severity labels only; never contains the image description or its extracted text.

credits_used
number

Number of credits consumed by this request

external_id
string
incident_moderation_enabled
string

Per-call override of account incident logging: "true" forces persistence, "false" suppresses it. Omit for account default.

customer_id
string
metadata
object

Echo of the metadata you provided in the request