Moderation · iOS

Install

Install via CocoaPods — add the pod to your Podfile and run pod install. The SDK and its bundled models come with the pod; everything runs on-device with no external dependencies.

pod 'NosmaiModerationSDK', '~> 1.0'

Requirements: iOS 14+, arm64. In Info.plist add:

• NSCameraUsageDescription — required for the live-camera path.
• ITSAppUsesNonExemptEncryption = NO — the SDK only encrypts its own bundled models locally (export-compliance exempt). Without it, every TestFlight/App Store upload stalls on the encryption question.

Initialize

initialize is blocking (network + model load) — call it off the main thread. Returns false if the license is invalid/expired.

import NosmaiDetection

DispatchQueue.global(qos: .userInitiated).async {
    let ok = NosmaiSDK.initialize(licenseKey: "NOSMAI-XXXX")
}

Moderate an image

if let r = NosmaiSDK.analyzeImage(uiImage) {     // NosmaiResult?
    if r.isUnsafe {
        // r.detections -> [NosmaiObjectDetection], r.nsfw -> .safe/.warn/.block
    }
}

Moderate a video

NosmaiSDK.analyze(videoURL: url, frameIntervalMs: 500,
    progress: { p in /* 0...1 */ },
    completion: { result in /* result.isUnsafe, .categories, .flags */ })

Moderate text

Call initialize first — it validates the license; initializeText needs that before it can load the (encrypted) text model.

try? NosmaiSDK.initializeText()                  // after initialize(), off the main thread
if let t = NosmaiSDK.moderateText("some message") {
    if t.blocked { /* t.layer, t.category, t.matchedWord */ }
}

Live camera (AVCaptureSession)

Feed pixel buffers from your AVCaptureVideoDataOutput to pushFrame; results arrive via the NosmaiListener.

NosmaiSDK.startStream(listener: self)            // self: NosmaiListener

// in captureOutput(_:didOutput:from:)
if let pb = CMSampleBufferGetImageBuffer(sampleBuffer) {
    NosmaiSDK.pushFrame(pb, rotationDegrees: 90)  // 90 makes a back-camera portrait buffer upright
}

// on leave
NosmaiSDK.stopStream()

Show the preview with an AVCaptureVideoPreviewLayer backed by the same AVCaptureSession.

Thresholds

NosmaiSDK.setThreshold(.weapon, value: 0.70)
NosmaiSDK.setNsfwThreshold(.explicit, value: 0.45)  // BLOCK
NosmaiSDK.setNsfwThreshold(.sexy, value: 0.55)      // WARN

Cleanup

NosmaiSDK.shutdown()