Documentation/Image uploads
Getting started

Image uploads

Submit private image files or approved image URLs through the same moderation workflow.

API v1Developer guide

Upload files from the workspace

Open Submit images and choose Upload images. Select 1–8 JPEG, PNG or WebP files, enter a reference and choose checks or a saved workflow. Click Upload & check to submit. Progress and results appear on the same page. New jobs update about every two seconds, with slower updates for longer waits; processing time depends on the selected checks and service load. Limits are 10 MiB per file, 16 megapixels per image and 20 MiB total. Animated and malformed images are rejected.

Choose Image URLs to keep using approved public HTTPS hosts. Uploads do not need a public hostname. Both methods require an active account and available image checks, and share quotas, billing and job history.

Send multipart form data

POST /api/v1/jobs/upload accepts reference, repeated images[] file parts, and either checks[] or workflow_id. Use your bearer credential and an Idempotency-Key. Let the HTTP client generate Content-Type and its multipart boundary.

A 202 response means the job was accepted. Poll the same /api/v1/jobs/{job_id} endpoint. Retry the same ordered image bytes, reference and selections with the same key; different bytes return 409, even if the filename is unchanged.

Private processing and retention

Uploaded files are private and are removed from active processing storage after the job finishes. No public download link is created. Backups may retain older copies under the service retention policy.

Invalid files fail processing and are never treated as a passing result. File and URL submissions use the same operation allowance.