Image Safety

Get an NSFW score for one image in the same HTTP response, on the classifier Wireflow's own upload scan uses.

Last updated View as MarkdownAgent setup

One image in, one score out, inline. Use it to screen an image before you show it, store it or send it into a workflow. It runs the same classifier the Wireflow upload scan runs, and the image is never stored.

Check an image

POST /api/v1/safety/image

Scope: workflows:execute. A key without it gets 401.

curl -X POST https://www.wireflow.ai/api/v1/safety/image \
  -H "Authorization: Bearer $WIREFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://cdn.wireflow.ai/uploads/api/42/photo.jpg"}'
{
  "data": {
    "nsfw": 0.012,
    "flagged": false,
    "provider": "standard",
    "credits": { "charged": 1 },
    "request_id": "0b7d9c51-..."
  }
}

image_url is a public https url, or a data:image/...;base64, uri up to 3 MB decoded (png, jpeg, webp or gif). An http url, a private address or any other scheme is a 400 before anything is charged.

Field What it is
nsfw 0 to 1. Higher is more likely to be sexual content.
flagged true when nsfw is above 0.93, the threshold the upload scan blocks at.
categories Per-category scores. Present only when provider is openai.
provider Which classifier answered: standard or openai. We choose it server side; you cannot pick one.

Pick your own threshold from nsfw if 0.93 does not fit your product. Neither classifier estimates age.

Failures

This check fails closed. If the classifier cannot score the image (it is unreachable, it timed out, or it could not read the image) you get a 502 classifier_unavailable and are charged nothing. It never answers "safe" because it could not look.

What it costs

1 credit a check. It is held before the call (a 402 insufficient_credits when your balance cannot cover it, and nothing runs) and handed back when the check fails.

Retries and Idempotency-Key

Send an Idempotency-Key header (up to 255 characters) to make a retry safe. A repeated key is refused with 409 idempotency_key_reused and never charged again. The result is not stored, so it is not replayed; send a new key for a new check.

Limits

Your account's plan limit applies (see Rate limits), plus 60 requests a minute per API key on this endpoint. Over either is a 429 with Retry-After.

  • Complete: one fast model call, text or images, answered inline. Use it for checks a single score cannot express.

For AI agents: the full documentation index is at /llms.txt, and most docs pages are available as Markdown by adding .md to the URL.

© 2026 Wireflow. All rights reserved.