MODERALENS API · V1

Overview & quickstart

Add image checks to your application with a server-side REST API. Submit files or allowed image URLs, then retrieve the asynchronous result.

Your first integration

  1. Activate your account

    Register or sign in to the workspace. New clients need administrator activation before API access. Check your allowance and permitted image sources.

    Account setup →
  2. Create an integration key

    Use your customer session to create a key. Copy the one-time mv_ value and keep it in your backend environment.

    Create or rotate a key →
  3. Select available checks

    Read capabilities. Choose explicit checks, or omit them for the five defaults. Use an enabled saved workflow instead of checks for reusable thresholds.

    List capabilities →
  4. Submit an image

    Start with a private file upload. Send a unique idempotency key and your business reference. A 202 response means queued, not approved.

    Upload images →
  5. Retrieve and apply the result

    Poll with backoff, for example 2 seconds increasing to 10. Stop on completed or failed; route uncertain and failed outcomes to review.

    Retrieve a job →
Follow the full implementation guide →