nsfw — 軽量NSFW(アダルト画像)識別API

AI/ML

概要

このリポジトリは、Hugging Face上の AdamCodd/vit-base-nsfw-detector をベースにした軽量なNSFW(成人向け)画像検出サービスをHTTP APIとして提供する実装です。特徴はCPUでの推論に最適化されており、低リソース環境のVPSやクラウドインスタンスで動作する点。対応画像形式はjpg/png/bmp/webpで、認証(API鍵等)による保護、Dockerを用いた簡単なデプロイ、リクエストに対する迅速な判定を目指しています。AI生成画像への検出性能は限定的であり、運用では自動判定+人の確認を併用することが推奨されます。

GitHub

リポジトリの統計情報

  • スター数: 27
  • フォーク数: 4
  • ウォッチャー数: 27
  • コミット数: 17
  • ファイル数: 10
  • メインの言語: HTML

主な特徴

  • 纯CPU推理に対応し、低コストなサーバで稼働可能
  • jpg/png/bmp/webpの画像形式をサポートしHTTP APIで判定可能
  • 認証機能やDockerによる簡易デプロイを用意
  • 軽量でリソース消費が少なく、速度も比較的速い

技術的なポイント

このプロジェクトは、ViT(Vision Transformer)アーキテクチャを用いた既存のNSFW検出モデル(AdamCodd/vit-base-nsfw-detector)を採用し、実運用向けにラップした点が肝です。主な技術的工夫は「CPUファースト」の方針で、GPUがない環境でも実用的な推論応答時間を確保するよう設計されています。具体的にはモデルのロードや前処理/後処理を軽量化し、HTTPサーバー(軽量フレームワーク想定)から画像を受け取って即座にスコアリングを行い、閾値判定でNSFWの有無を返します。また、画像フォーマットの変換やサイズリサイズ、バッチ処理の抑制など、メモリとCPU負荷を抑える工夫がされていることが想定されます。実装上の利便性を高めるためにDockerfileや認証ロジックを同梱しており、プライベートなAPIとして社内やサービス内に簡単に組み込めます。注意点として、作者自身の検証でも「実写や通常の写真に対しては精度良好だが、AI生成画像の判定は弱い」ことが明記されており、完全自動化は推奨されません。運用ベストプラクティスとしては、機械判定でスクリーニング→疑わしいものを人が再確認するハイブリッドワークフローが提案されています。ライセンスファイルも同梱されており、利用時の権利関係も確認可能です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • Dockerfile: file
  • LICENSE: file
  • README.md: file
  • README_en.md: file

…他 5 ファイル

まとめ

軽量でCPU環境向け、プライベート運用に適した実用的なNSFW判定API。

リポジトリ情報:

READMEの抜粋: 中文说明 | English

helloxz/nsfw

关于

此项目基于AdamCodd/vit-base-nsfw-detector/ 实现,并封装为HTTP API调用,可用于识别网络色情图像(nsfw识别),适合纯CPU机器推理,轻量级实现方案。

AdamCodd/vit-base-nsfw-detector是基于ViT架构的保守型NSFW检测模型,能识别真实图片和绘画中的敏感内容,但对AI生成图片准确率较低。

备注:xiaoz亲测能识别大多数色情图像,个人主观感觉识别准确度高于Open NSFW,但做不到100%精准(目前市面上不存在完全精准的识别方案,建议机器初审 + 人工复审)。

特点

  • 纯CPU推理,适合大多数云服务器或VPS
  • 支持的图片类型:jpg/png/bmp/webp
  • 支持HTTP API调用
  • 支持鉴权访问
  • 轻量级实现,资源占用较低
  • 识别速度较快
  • 支持D…