# ban.wtf APIs

> High-precision, credit-based Image and Text Moderation API Gateway built for Discord bots, web applications, and autonomous AI agents.

ban.wtf APIs provide sub-50ms text safety scoring, zero-day raid filtering, phishing/scam detection, explicit adult/NSFW image classification, and face age estimation.

## Documentation & Machine-Readable Links

- [Full LLM Context Documentation](https://apis.ban.wtf/llms-full.txt): Complete un-truncated reference with parameters, cURL, TypeScript, and Python snippets.
- [OpenAPI 3.1.0 Specification](https://apis.ban.wtf/openapi.json): Standard machine-readable OpenAPI JSON schema.
- [AI Plugin Manifest](https://apis.ban.wtf/.well-known/ai-plugin.json): Agent and Custom GPT discovery manifest.
- [Web Documentation](https://apis.ban.wtf/docs): Human-readable developer guide with live playground links.

## Core API Endpoints

- [POST https://apis.ban.wtf/api/v1/moderate/text](https://apis.ban.wtf/docs#text-moderation): Evaluates a single message for phishing/scams, toxicity, and zero-day raids. Returns recommended action ('ban', 'timeout', 'warn', 'none'). Cost: 0.5 credit/message.
- [POST https://apis.ban.wtf/api/v1/moderate/text/batch](https://apis.ban.wtf/docs#batch-moderation): Concurrently evaluates up to 50 messages in one request. Cost: 0.5 credit/message.
- [POST https://apis.ban.wtf/api/v1/moderate/image](https://apis.ban.wtf/docs#image-moderation): Classifies explicit nudity, anime/drawn nudity, and performs face age estimation. Accepts URL, base64, or multipart/form-data. Cost: 1 credits/image.
- [GET https://apis.ban.wtf/api/pricing](https://apis.ban.wtf/api/pricing): Returns real-time system pricing rates. Cost: Free.
- [GET https://apis.ban.wtf/api/v1/moderate/health](https://apis.ban.wtf/api/v1/moderate/health): Health checks for the gateway and upstream AI models. Cost: Free.

## Authentication

All moderation requests require an active secret key prefixed with `bw_live_`.
Provide it via either header:
```http
Authorization: Bearer bw_live_YOUR_KEY
```
or:
```http
x-api-key: bw_live_YOUR_KEY
```

## Quick cURL Example

```bash
curl -X POST "https://apis.ban.wtf/api/v1/moderate/text" \
  -H "Authorization: Bearer bw_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "FREE NITRO at https://fake-gift.ru @everyone",
    "author": "spambot#1337"
  }'
```