# NSFW Image Detection - Core.Today AI API

> The standard NSFW image classifier (127M+ runs) — returns 'normal' or 'nsfw' for any image. An essential, ultra-cheap moderation gate for UGC platforms.

- **Provider**: Falcons.ai
- **Model ID**: falcons-ai/nsfw_image_detection
- **Category**: Image Generation
- **Credits**: 1 per image
- **Speed**: Fast
- **Quality**: High

## Features
- 127M+ runs — the moderation standard
- Simple normal/nsfw output
- 1 credit per image — run on every upload
- Fast enough for synchronous gates

## Use Cases
- UGC upload moderation
- Profile photo screening
- Marketplace listing review
- Generated-image safety gate
- Chat image filtering

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **image**: string - Image to classify

## Examples

### Upload Moderation Gate
Classify a user upload before publishing
```json
{
  "model": "falcons-ai/nsfw_image_detection",
  "input": {
    "image": "https://example.com/user-upload.jpg"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Returns the string 'normal' or 'nsfw' — branch your pipeline on it
- At 1 credit, run it on every image upload without budget concerns
- Combine with human review for borderline categories your policy cares about

## Documentation
https://replicate.com/falcons-ai/nsfw_image_detection