---
title: Image Safety
description: Get an NSFW score for one image in the same HTTP response, on the classifier Wireflow's own upload scan uses.
updated: 2026-11-19
---

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`.

```bash
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"}'
```

```json
{
  "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](/docs/api/rate-limits)), plus 60 requests a minute per API key on this endpoint. Over either is a `429` with `Retry-After`.

## Related

- [Complete](/docs/api/complete): one fast model call, text or images, answered inline. Use it for checks a single score cannot express.

Last updated: 2026-11-19

---

Documentation index: fetch https://www.wireflow.ai/llms.txt for the full list of Wireflow docs.
