AniWaifu API

Random Anime Waifu Image Generator

Welcome to the AniWaifu API — a simple and fast REST API that returns random anime waifu images, with support for tag filtering and custom image hosting via GitHub + Vercel.

Features

• 🎴 Get a random waifu image
• 🔖 Filter waifus by tag (?tag=sfw & ?tag=nsfw)
• 📃 List all waifus with name, tags, and image
• ☁️ Self-hosted images (no external CDN needed)
• 🆓 Fully free, works with Vercel + GitHub

A lightweight API to fetch random anime waifu images with tag filtering

API Features

• /api/waifu - Get random waifu
• /api/waifu?tag=<tag> - Filter by tag (e.g., sfw, nsfw)
• Images served via GitHub + Vercel CDN

Quick Start

# Get random waifu
curl https://aniwaifu.vercel.app/api/waifu

# Get waifu with 'sfw' tag
curl https://aniwaifu.vercel.app/api/waifu?tag=sfw

Sample Response

{
  "name": "Zero Two",
  "image": "https://aniwaifu.vercel.app/images/zero-two.jpg",
  "tags": "sfw"
}

Project Structure

(Private Source Code)

/aniwaifuapi
├── api
│   ├── waifu.js      # /api/waifu endpoint
├── data
│   └── waifus.json   # Waifu metadata
├── public
│   └── images        # Hosts all images
│       ├── zero-two.jpg
│       ├── rem.jpg
│       └── ...
└── vercel.json        # Deployment config

Adding Images

Upload images to public/images/ via GitHub mobile/web

Add entry in data/waifus.json:

{
  "name": "Character Name",
  "image": "/images/filename.jpg",
  "tags": ["tag1", "tag2"]
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

Loved My Work?

 Give a star to this project
 Follow me on GitHub

Wondering where to get these animated emojis? Visit here! You also should look around my other github repos. Maybe you'll find some cool useful stuff there.

Contact

For inquiries or collaborations:

^{Copyright © 2025 Shinei Nouzen All Rights Reserved}