NSFW Detection API Usage & Content Analysis

Analyze images for NSFW content using Voyant’s AI models. Supports single and batch image processing via secure signed requests.

Base URL: https://api.voyantnetworks.com
Endpoints:
• /v1/nsfw/analyze
• /v1/nsfw/analyze/batch

Request Flow (Pseudo)

1. payload = { accountId, apiKey, projectId, nonce, timestamp }

   nonce     → random 10 digit string
   timestamp → milliseconds (Date.now())

2. stable = JSON.stringify(sorted(payload))
   ⚠️ keys MUST be sorted alphabetically

3. signature = HMAC_SHA256(stable, apiSecret)

4. form-data:
   add apiKey, projectId, nonce, timestamp, signature
   ⚠️ append these BEFORE file

5. attach file:
   single  → "image"
   batch   → "images" (max 5)

6. POST → /v1/nsfw/analyze or /batch

Official SDKs & Libraries

Use official SDKs for faster integration across platforms.

Node.js

Backend / Server-side

npm →

JavaScript (Browser)

Frontend / Web

js script →

Flutter

Mobile / Web Apps

pub.dev →

Python

Backend / ML / Scripts

coming soon

SDK Usage (Recommended)

//  nodejs usage below // read sdk readme from above links
const creds = {
  apiKey: "YOUR_API_KEY",
  accountId: "YOUR_ACCOUNT_ID", // 🔥 REQUIRED
  apiSecret: "YOUR_API_SECRET"
};

const nsfw = new VoyantClient.NsfwApiClient({
  credentials: creds,
  projectId: "YOUR_PROJECT_ID"
});

// single
await nsfw.analyze(file);

// batch
await nsfw.analyzeBatch([file1, file2]);

Signature (All Languages)

payload = { accountId, apiKey, projectId, nonce, timestamp }

stable = JSON.stringify(sorted(payload))

signature = HMAC_SHA256(stable, apiSecret)

Single Image

curl -X POST https://api.voyantnetworks.com/v1/nsfw/analyze \
-F "accountId=..." \
-F "projectId=..." \
-F "apiKey=..." \
-F "nonce=..." \
-F "timestamp=..." \
-F "signature=..." \
-F "[email protected]"

import crypto from "node:crypto";
import fs from "fs";
import FormData from "form-data";
import fetch from "node-fetch";

const p = { accountId:"...", apiKey:"...", projectId:"...", nonce:"...", timestamp:Date.now() };
const s = JSON.stringify(Object.keys(p).sort().reduce((a,k)=>(a[k]=p[k],a),{}));
const sig = crypto.createHmac("sha256","SECRET").update(s).digest("hex");

const f = new FormData();
Object.entries({ ...p, signature:sig }).forEach(([k,v])=>f.append(k,v));
f.append("image", fs.createReadStream("file.jpg"));

const res = await fetch("https://api.voyantnetworks.com/v1/nsfw/analyze",{ method:"POST", body:f, headers:f.getHeaders() });
console.log(await res.json());

import hmac, hashlib, json, requests

p = {accountId:"...", "apiKey":"...","projectId":"...","nonce":"...","timestamp":"..."}
s = json.dumps(p, sort_keys=True)
sig = hmac.new(b"SECRET", s.encode(), hashlib.sha256).hexdigest()

res = requests.post(
  "https://api.voyantnetworks.com/v1/nsfw/analyze",
  data={**p,"signature":sig},
  files={"image":open("file.jpg","rb")}
)
print(res.json())

Batch

curl -X POST https://api.voyantnetworks.com/v1/nsfw/analyze/batch \
-F "projectId=..." -F "apiKey=..." -F "nonce=..." \
-F "timestamp=..." -F "signature=..." \
-F "[email protected]" -F "[email protected]"

f.append("images", fs.createReadStream("1.jpg"));
f.append("images", fs.createReadStream("2.jpg"));

files=[("images",open("1.jpg","rb")),("images",open("2.jpg","rb"))]

Response

{ "success": true, "nsfw": false }

Next Steps

Manage and optimize your NSFW API usage:

⚙️ Create NSFW API → 📊 Manage NSFW API → ⚠️ View Error Codes →