🔥 The fastest unofficial Google Gemini API — no keys, no limits, just results.

---

🌟 About Project

Gemini Realtime AI API is a fast, lightweight unofficial Google Gemini wrapper built on Flask.
It reverse-engineers Gemini's web interface to deliver real-time AI responses in clean JSON — zero API key required.

Perfect for Telegram bots, automation tools, Discord bots, web apps, and anything that needs AI responses instantly.

---

✨ Features

+ ⚡ Ultra Fast Realtime AI Responses
+ 🔓 No API Key Required — Works Out of The Box
+ 🤖 Smart Gemini AI Integration via Web Scraping
+ 🌐 Clean & Structured JSON Output
+ 🚀 Lightweight Flask Backend — Low Resource Usage
+ 📊 Rich Metadata — Response Time, Word Count, Timestamp
+ 💻 Perfect For Bots, Apps & Automation Tools
+ 🔄 Auto Session + Token Extraction Per Request
+ 🛡️ Built-in Error Handling & Clean Error Responses
+ 🆓 Completely Free To Use

---

🌍 Live API

https://mkworld.eu.org/api/ask?prompt=Hello,%20how%20are%20you

---

⚡ API Reference

Base URL

https://mkworld.eu.org

Endpoint

GET /api/ask

Parameters

Parameter	Type	Required	Description
prompt	string	✅ Yes	Your message or question for Gemini

---

💠 Example Request

curl "https://mkworld.eu.org/api/ask?prompt=Tell%20me%20a%20joke"

Or simply open in browser:

https://mkworld.eu.org/api/ask?prompt=Tell me a joke

---

📦 Example Response

{
  "success": true,
  "prompt": "Tell me a joke",
  "response": "Why don't programmers like nature? Because it has too many bugs! 😂",
  "metadata": {
    "response_time": "2.31s",
    "timestamp": "2026-05-02T12:00:00Z",
    "model": "gemini",
    "character_count": 68,
    "word_count": 14
  },
  "api_dev": "@bizft"
}

Error Response

{
  "success": false,
  "error": "Missing required parameter: prompt",
  "api_dev": "@bizft"
}

---

🚀 Quick Deploy

🟣 Railway

---

🔵 Render

Build Command	pip install -r requirements.txt
Start Command	gunicorn app:app

---

⚫ Vercel

Add a vercel.json in root — supports instant serverless deployment.

{
  "builds": [{ "src": "app.py", "use": "@vercel/python" }],
  "routes": [{ "src": "/(.*)", "dest": "app.py" }]
}

---

⚙️ Self Host

1. Clone

git clone https://github.com/mkhossainx/gemini-realtime-api.git
cd gemini-realtime-api

2. Install

pip install -r requirements.txt

3. Run

python app.py

4. Test

http://127.0.0.1:5000/api/ask?prompt=Hello

---

📁 Project Structure

gemini-realtime-api/
│
├── 🐍 app.py               ← Main Flask application
├── 📦 requirements.txt     ← Python dependencies
├── ⚙️  Procfile             ← For Railway / Heroku
├── 🏃 runtime.txt          ← Python version
├── ▲  vercel.json          ← Vercel config
└── 📄 README.md            ← Documentation

---

🛠 Tech Stack

Technology	Role
	Backend Logic
	API Framework
	HTTP Client
	HTML Parsing

---

📌 All Endpoints

Endpoint	Method	Description
/	GET	API info & usage
/api/ask	GET	Ask Gemini AI

---

⚠️ Disclaimer

This project is built for educational & research purposes only.
This is an unofficial implementation and is not affiliated with, endorsed by, or connected to Google in any way.
Use responsibly and at your own risk.

---

👨‍💻 Credits

💙 Developed By

🚀 Powered By

---

⭐ Support The Project

If this helped you:

---