https://github.com/shineii86/anichatapi

Free REST API for multi-character anime chatbot with real-time updates, quotes, recommendations, and images.
https://github.com/shineii86/anichatapi

anime anime-api anime-list anime-scraper anime-search anime-website animejs animes chatgpt gemini html javascript

Last synced: about 1 month ago
JSON representation

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

Host: GitHub
URL: https://github.com/shineii86/anichatapi
Owner: Shineii86
License: mit
Created: 2025-07-31T16:25:22.000Z (2 months ago)
Default Branch: main
Last Pushed: 2025-07-31T18:03:23.000Z (2 months ago)
Last Synced: 2025-07-31T19:53:25.363Z (2 months ago)
Topics: anime, anime-api, anime-list, anime-scraper, anime-search, anime-website, animejs, animes, chatgpt, gemini, html, javascript
Language: HTML
Homepage: https://anichatapi.vercel.app
Size: 60.5 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          


  

# [AniChatAPI](https://github.com/AniPulse)

*Your Ultimate Anime Chatbot Engine*

![Vercel](https://img.shields.io/badge/Deployed-Vercel-black?style=flat&logo=vercel)

![Issues](https://img.shields.io/github/issues/Shineii86/AniChatAPI)

![License](https://img.shields.io/badge/License-MIT-brightgreen.svg)

![Last Commit](https://img.shields.io/github/last-commit/Shineii86/AniChatAPI?style=for-the-badge)

![Repo Size](https://img.shields.io/github/repo-size/Shineii86/AniChatAPI?style=for-the-badge) [![GitHub Stars](https://img.shields.io/github/stars/Shineii86/AniChatAPI?style=for-the-badge)](https://github.com/Shineii86/AniChatAPI/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/Shineii86/AniChatAPI?style=for-the-badge)](https://github.com/Shineii86/AniChatAPI/fork)

[![API Status](https://img.shields.io/website?down_color=lightgrey&down_message=offline&label=API%20Status&style=for-the-badge&up_color=green&up_message=online&url=https%3A%2F%2Fanichat.vercel.app)](https://anichat.vercel.app)



> 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

```json

{

  "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:

```json

// 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](https://jikan.moe)             |

| AnimeChan       | Anime quotes           | [animechan.io](https://animechan.io)      |

| Waifu.pics      | Anime image generation | [waifu.pics](https://waifu.pics/)          |

| OpenAI / Gemini | Conversational AI      | [openai.com](https://openai.com) / [makersuite.google.com](https://makersuite.google.com) |

---

## 🧪 Getting Started

### 1. Clone the Repository

```bash

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](https://platform.openai.com/account/api-keys).

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](https://makersuite.google.com/).

2. Sign in with your Google account.

3. Go to the **"API Keys"** section or [click here directly](https://aistudio.google.com/app/apikey).

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](https://vercel.com/) and import your repo

* Vercel auto-detects the API

---

## 🧪 Sample Request

```bash

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

```

**Response**:

```json

{

  "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:

* [Jikan API](https://jikan.moe/)

* [AnimeChan](https://animechan.io)

* [Waifu.pics](https://waifu.pics/)

* [OpenAI](https://openai.com/)

* [Google Gemini](https://makersuite.google.com/)

* [Vercel](https://vercel.com/)

---

## 👤 Credits

> Project created by [**Shinei Nouzen**](https://github.com/Shineii86) Build with ❤️ passion for Anime, AI, and Open Source.

---

## 📬 Support

* Issues: [GitHub Issues](https://github.com/Shineii86/AniRecommendAPI/issues)

## 🪪 License

```json

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](https://github.com/Shineii86/Shineii86)

⭐ [Give a star to this project](https://github.com/Shineii86/AniChatAPI/)







## ☎️ Contact



  

  *For inquiries or collaborations*

     

[![Telegram Badge](https://img.shields.io/badge/-Telegram-2CA5E0?style=flat&logo=Telegram&logoColor=white)](https://telegram.me/Shineii86 "Contact on Telegram")

[![Instagram Badge](https://img.shields.io/badge/-Instagram-C13584?style=flat&logo=Instagram&logoColor=white)](https://instagram.com/ikx7.a "Follow on Instagram")

[![Pinterest Badge](https://img.shields.io/badge/-Pinterest-E60023?style=flat&logo=Pinterest&logoColor=white)](https://pinterest.com/ikx7a "Follow on Pinterest")

[![Gmail Badge](https://img.shields.io/badge/-Gmail-D14836?style=flat&logo=Gmail&logoColor=white)](mailto:ikx7a@hotmail.com "Send an Email")

  ^{Copyright © 2025 Shinei Nouzen All Rights Reserved}

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/shineii86/anichatapi

Awesome Lists containing this project

README