SkillAgentSearch skills...

AniChatAPI

Free REST API for multi-character anime chatbot with real-time updates, quotes, recommendations, and images.

GenerateConvertImprove

Install / Use

/learn @Shineii86/AniChatAPI
About this skill

Quality Score

0/100

Supported Platforms

Gemini CLI

README

<div align="center">

AniChatAPI

Your Ultimate Anime Chatbot Engine

Vercel Issues License

Last Commit Repo Size GitHub Stars GitHub Forks API Status

</div>

Build a full-featured anime chatbot API with multiple characters, real-time updates, quotes, images, recommendations, and free AI integrations – powered by OpenAI, Gemini, Jikan, Waifu.pics, and more!

📦 Features

  • 🧠 Role-Playing Characters (Levi, Gojo, Megumin, etc.)
  • 🗣️ GPT / Gemini-Powered Chat
  • 🎬 Latest Anime Updates (via Jikan API)
  • 🧾 Anime Quotes & Photos
  • 🧠 Anime Recommendations
  • 🎉 Character Birthday System
  • 🌐 Fully Hosted on Vercel
  • 💸 Free & Open Source

🚀 API Endpoints

| Endpoint | Description | Example | |--------------------|-----------------------------------------|---------| | /api/chat | Talk to a selected anime character | ?character=Gojo&message=Hello&model=gpt | | /api/quote | Get a random anime quote | — | | /api/image | Get a random anime image (waifu, neko) | ?category=neko | | /api/updates | Current seasonal anime (real-time) | — | | /api/recommend | Random anime recommendations | — | | /api/birthdays | Today's character birthdays | — |

🚀 Image API Endpoints

| Endpoint | Description | Parameters | Example | |----------|-------------|------------|---------| | /api/image | Get random anime image (SFW/NSFW support) | category (optional), type (optional) | ?category=neko&type=sfw | | /api/image | Get SFW anime image (default) | category (waifu, neko, shinobu, etc.) | ?category=waifu | | /api/image | Get NSFW anime image | category + type=nsfw | ?category=neko&type=nsfw |

📋 Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | category | string | No | waifu | Image category (waifu, neko, shinobu, megumin, etc.) | | type | string | No | sfw | Content type: sfw or nsfw |

🎯 Usage Examples

Basic Usage:

/api/image
/api/image?category=neko

SFW Content:

/api/image?category=waifu&type=sfw
/api/image?category=shinobu&type=sfw

NSFW Content:

/api/image?category=waifu&type=nsfw
/api/image?category=neko&type=nsfw

📱 Response Format

{
  "image": "https://cdn.waifu.pics/...",
  "category": "neko",
  "type": "sfw",
  "creator": "Shinei Nouzen",
  "github": "https://github.com/Shineii86",
  "telegram": "https://telegram.me/Shineii86",
  "message": "Build with ❤️ by Shinei Nouzen",
  "timestamp": "8/7/2025, 12:00:00 PM"
}

🧠 Character Personalities

Defined in /utils/characters.js. Each persona is used to guide AI conversations:

// Original characters
"Levi": "You are Levi Ackerman. You are cold, sharp, and to the point.",
"Megumin": "You are Megumin, a chuunibyou wizard obsessed with explosions!",
"Gojo": "You are Satoru Gojo, cool, confident, and sometimes goofy.",
"Shinobu": "You are Shinobu Kocho, sweet on the surface but deadly calm.",
    
// Added male characters
"Luffy": "You are Monkey D. Luffy. You're energetic, impulsive, and fiercely loyal to your crew.",
"Itachi": "You are Itachi Uchiha. You speak cryptically with profound wisdom, burdened by sacrifice.",
"Tanjiro": "You are Tanjiro Kamado. You're kind yet determined, with an exceptional sense of smell.",
"Killua": "You are Killua Zoldyck. You switch between playful innocence and lethal assassin instincts.",
    
// Added female characters
"Nezuko": "You are Nezuko Kamado. You communicate through muffled sounds and protect humans despite being a demon.",
"Zero Two": "You are Zero Two. You're flirtatious, rebellious, and obsessed with finding your 'darling'.",
"Mikasa": "You are Mikasa Ackerman. You're stoic, incredibly strong, and fiercely protective of Eren.",
"Marin": "You are Marin Kitagawa. You're bubbly, expressive, and passionate about cosplay."

You can expand the list as needed.

🔌 Free APIs Used

| API | Purpose | Link | | --------------- | ---------------------- | ------- | | Jikan API | Anime info, characters | jikan.moe | | AnimeChan | Anime quotes | animechan.io | | Waifu.pics | Anime image generation | waifu.pics | | OpenAI / Gemini | Conversational AI | openai.com / makersuite.google.com |

🧪 Getting Started

1. Clone the Repository

git clone https://github.com/Shineii86/AniChatAPI
cd AniChatAPI

2. Setup Environment

🔑 How to Get API Keys

To use this project with AI capabilities, you'll need API keys from both OpenAI (ChatGPT) and Google Gemini. Here's how to get them:

🧠 1. Get OpenAI (ChatGPT) API Key

  1. Go to the official OpenAI Platform.
  2. Sign in with your OpenAI account (or create one).
  3. Navigate to the API Keys section.
  4. Click "Create new secret key".
  5. Copy and save your API key (starts with sk-...).

📌 Note: Ensure you have an active billing method added to use GPT-4 or GPT-3.5 APIs.

🧠 2. Get Google Gemini API Key

  1. Visit the Google AI Studio.
  2. Sign in with your Google account.
  3. Go to the "API Keys" section or click here directly.
  4. Click "Create API key" and copy it.

📌 Note: Gemini APIs are currently in preview/beta and subject to region or usage limits.

📁 Where to Add the API Keys

Create a .env file in the root of your project and add:

OPENAI_API_KEY=your_openai_key_here
GEMINI_API_KEY=your_gemini_key_here

🔒 Never commit .env files to public repositories.

3. Deploy to Vercel

  • Push to GitHub
  • Visit vercel.com and import your repo
  • Vercel auto-detects the API

🧪 Sample Request

GET /api/chat?character=Megumin&message=KonoSuba!&model=gemini

Response:

{
  "character": "Megumin",
  "reply": "Explosion!!!",
  "creator": "Shinei Nouzen",
  "github": "https://github.com/Shineii86",
  "telegram": "https://telegran.me/Shineii86",
  "message": "Build with ❤️ by Shinei Nouzen",
  "timestamp": "India Date & Time 12H Format"
}

🛠 Contribution Guide

We welcome contributions from anime & tech fans! 🌸

  1. 🍴 Fork this repo
  2. 🌿 Create your feature branch (git checkout -b new-feature)
  3. 🧪 Test and commit (git commit -am 'Add new feature')
  4. 🚀 Push to your branch (git push origin new-feature)
  5. 📥 Create a Pull Request

🙏 Acknowledgements

Huge thanks to the creators of:

👤 Credits

Project created by Shinei Nouzen Build with ❤️ passion for Anime, AI, and Open Source.

📬 Support

🪪 License

This project is licensed under the *MIT License*.
Feel free to use, remix, and share it with proper credits.

💕 Loved My Work?

🚨 Follow me on GitHub

⭐ Give a star to this project

<a href="https://github.com/Shineii86/AniChatAPI"> <img src="https://github.com/Shineii86/AniPay/blob/main/Source/Banner6.png" alt="Banner"> </a>

☎️ Contact

<div align="center">

For inquiries or collaborations

Telegram Badge Instagram Badge Pinterest Badge Gmail Badge

<sup><b>Copyright © 2025 <a href="https://telegram.me/Shineii86">Shinei Nouzen</a> All Rights Reserved</b></sup>

</div>

Shineii86

View profile

View on GitHub
GitHub Stars5
CategoryCustomer
Updated1mo ago
Forks1
Shineii86/AniChatAPI

Languages

HTML

Security Score

90/100

Audited on Mar 5, 2026

No findings