Image Safety
Get an NSFW score for one image in the same HTTP response, on the classifier Wireflow's own upload scan uses.
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.
Related
- Complete: one fast model call, text or images, answered inline. Use it for checks a single score cannot express.