ImageGuard

What it does

POST an image URL or base64 image and receive an NSFW confidence score (0–1). Optional threshold_advisory triggers a per-class flagged boolean. SSRF-hardened: private IP ranges blocked before any payment is attempted. Composes naturally with image-generation pipelines and ScrapePay — any agent that handles user-facing or scraped imagery should gate on ImageGuard before storing or displaying content. Currently NSFW-only; multi-class moderation (violence, weapons, hate, self-harm, gore, drugs) is on the roadmap.

When to use it

• Screen a generated image from an image-generation tool before storing in a user-facing gallery
• Validate scraped images from ScrapePay before displaying to users
• NSFW gate for a user-submitted-image pipeline
• Safety check on screenshots before including them in published reports

Request schema

{
  "image_url": "https://example.com/photo.jpg",
  "threshold_advisory": 0.7
}

Response schema

{
  "success": true,
  "scores": {
    "nsfw": 0.023
  },
  "flagged": {
    "nsfw": false
  },
  "scored_at": "2026-05-15T13:48:46Z",
  "model_version": "imageguard-v1.0",
  "payment_hash": "0x..."
}

Code example — TypeScript via MCP

Install the MCP server once; all 22 services become tool calls.

// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:

const result = await mcpClient.callTool("imageguard", {
  "image_url": "https://example.com/photo.jpg",
  "threshold_advisory": 0.7
});

console.log(result);
// ["success","scores","flagged","scored_at","model_version","p...

Code example — Python via direct HTTP

import requests

# x402 payment header must be set by your wallet client
# See x402.org for client libraries

headers = {
    "Content-Type": "application/json",
    "x-payment": "<signed-x402-payment-header>",
}

resp = requests.post(
    "https://imageguard.melis.ai/score",
    json={
      "image_url": "https://example.com/photo.jpg",
      "threshold_advisory": 0.7
    },
    headers=headers,
)
print(resp.json())

Code example — curl with internal key bypass

For testing with an issued internal key (skips x402 payment flow):

curl -X POST https://imageguard.melis.ai/score \
  -H "Content-Type: application/json" \
  -H "x-internal-key: YOUR_KEY" \
  -d '{"image_url":"https://example.com/photo.jpg","threshold_advisory":0.7}'

How is this different from alternatives?

Related services

FAQ