Skip to main content
POST
Analyze video for visual safety concerns across extracted frames

Authorizations

Authorization
string
header
required

API key as Bearer token

Response

200 - application/json

Default Response

file_id
string
frames_analyzed
number
duration_seconds
number
frame_results
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), from the frame that drove it.

Routing key, weakest to strongest: none, monitor, flag_for_review, block, immediate_intervention. Safe to switch on. A video whose frames could not be decoded returns flag_for_review, never none.

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 frame descriptions.

flagged_timestamps
object[]
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