欢迎回来，开发者

实时监控 API 图像识别吞吐、并发在途配额及账户资金消费

可用积分余额 💳

102,450

基础: 100,000 | 赠送: 2,450 (预占 12)

并发在途 / 上限 ⚡

12 / 75

QPS 上限: 5 | 轮询: 1,500/min

任务成功率 (7天) 🎯

99.60%

成功 48,210 次 | 失败 194 (已全额释放)

P50 处理耗时 / 错误率 ⏱️

1.18s / 0.08%

P95: 2.35s (直方桶估算) | 网关 42ms

检测任务与消费趋势 (UTC)

每日成功检测数（消费 1 积分）与失败释放统计

成功检测 (48,210) 异常释放 (194)

09-07

09-08

09-09

09-10

09-11

09-12

今日

API 密钥调用占比

按各 Key 的实际请求吞吐统计

Prod-API-Cluster 78% (37,600 次)

Staging-Test-Key 15% (7,200 次)

Batch-Worker-01 7% (3,410 次)

🛡️ 异常拦截遥测：近7天拦截 429 超频请求 12 次、422 图片格式错误 4 次，均未扣除积分。

创建时间 (UTC)	任务 ID	状态	审核判定	处理总耗时	积分变动	归属 Key
14:20:00	01992500-0001	Succeeded	违规 (L3)	1,180ms	-1 (paid)	Prod-API
14:18:12	01992500-0002	Succeeded	合规放行 (L1)	940ms	-1 (paid)	Prod-API
14:15:30	01992500-0003	Failed	取图失败 (404)	5,200ms	+1 全额释放 (0扣费)	Test-Key

API 密钥管理与安全凭证

所有有效密钥共用账户余额与 QPS 并发配额，每个账户最多支持 10 个有效密钥。

当前有效配额：3 / 10 个已激活

格式规范：生产环境采用 nfw_live_<base64url>，测试环境采用 nfw_test_...

密钥名称	Key 标识 (已脱敏)	状态	创建时间	最后调用	操作管理

总可用积分余额 💳

102,450

基础积分: 100,000 | 赠送积分: 2,450

会员等级与赠分加成 ⭐

Silver (+3% 赠分)

累计消费 102,450 分 | 永久晋级只升不降

接口并发与在途配额 🚀

5 QPS / 75 并发

无未清偿债务 (debt: 0)

在线充值积分 ($1 = 2,000 基础积分，单张成功识别低至 $0.00048)

接入国际 Stripe Checkout 支付，支持 Visa、MasterCard 及主流银联快捷支付，充值自动晋级

$10.00

20,600 积分

基础 20,000 + Silver 赠送 600 积分
平均 $0.000485 / 张

推荐首选 (3% 加赠)

$50.00

103,000 积分

基础 100,000 + Silver 赠送 3,000 积分
满足高并发业务批量检测

$100.00

206,000 积分

基础 200,000 + Silver 赠送 6,000 积分
适合长期高频企业调用

时间 (UTC)	事件类型	关联业务凭证	积分变动 (Delta)	变动后可用余额	备注说明

NSFW Check 开发者接入指南

标准 RESTful API，基于 C++/ncnn 高性能推理后端，支持异步提交、任务轮询与幂等控制。

1. 提交图片检测任务

向 POST /v1/predictions 发送图片 HTTPS URL。系统在可用余额中预占 1 积分并立即返回 201 Created 与 Task ID：

curl -X POST https://api.nsfw-check.com/v1/predictions \
  -H "Authorization: Bearer nfw_live_YOUR_KEY" \
  -H "Idempotency-Key: your_random_unique_key_001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "general",
    "input": { "image": "https://example.com/photo.jpg" },
    "policy": { "sensitivity": "standard" }
  }'

Idempotency-Key 为可选（推荐）请求头：提供时，同一次提交若响应丢失，可直接重发同一请求并复用同一个键，服务端返回原任务而不重复预占或扣费；省略该头则不启用幂等保护，重复提交会各建一个任务并分别计费。

2. 轮询检测结果

根据响应的 Location 头或 Task ID 发起 GET 请求轮询。遵循服务端的 Retry-After 等待头：

curl -X GET https://api.nsfw-check.com/v1/predictions/01992500-0000-7000-8000-000000000001 \
  -H "Authorization: Bearer nfw_live_YOUR_KEY"

3. 响应字段结构 (Task DTO)

{
  "id": "01992500-0000-7000-8000-000000000001",
  "status": "succeeded",
  "model_version": "general-2026-08",
  "output": {
    "is_violation": true,
    "classification": {
      "level": "L3",
      "probabilities": { "L1": 0.03, "L2": 0.12, "L3": 0.81, "L4": 0.04 }
    }
  },
  "created_at": "2026-09-13T14:20:00Z"
}