Skip to main content
POST

Authorizations

Authorization
string
header
required

Supabase user JWT (or an internal service token). Send as Authorization: Bearer <token>.

Body

urls
string[]
required

Items to upload. Each can be an HTTPS URL, a data URI (data:mime;base64,...), or a raw base64 string (requires mime_type). Maximum 20 items.

Required array length: 1 - 20 elements
Example:
nsfw_check
boolean
default:true

Run NSFW classifier on images.

purpose
string

Label for the upload batch.

Example:

"group-photo-input"

tool
string

Tool name that triggered this upload.

Example:

"group-photo"

mime_type
string

MIME type hint, required when urls contains raw base64 strings.

Example:

"image/png"

Response

Upload processed. Check summary.failed and per-item error fields for partial failures.

status
integer
Example:

200

results
object[]
summary
object