FTM-AI — API Documentation

Introduction

FTM-AI REST API

FTM-AI ek Hinglish AI platform hai jisme 10 unique Indian AI personas hain. Yeh API tumhare project mein integrate karne ke liye hai — chatbots, apps, websites — sab kuch. JWT-based authentication use hoti hai.

BASE URL

🔑 JWT Auth 🌐 REST API 🇮🇳 Hinglish AI 🤖 10 Personas 🎨 Image Gen 🧵 Chat History

Authentication

API Key Setup

FTM-AI API ke liye JWT Bearer token chahiye. Pehle account banao, phir admin se key approve karwao.

🔑

API Key Kaise Milegi?

3 simple steps

Register karo — /register pe account banao. Completely free.

API Key Request karo — Dashboard pe jaake "Developer API Key" section mein request submit karo. Reason likhna optional hai.

Admin Approve Karega — Jaise hi approve hoga, Dashboard pe tumhari JWT key milegi. Copy karo aur API calls mein use karo.

Authorization Header

# Har API request mein yeh header add karo:
Authorization: Bearer YOUR_API_KEY_HERE

Python Example

Python

cURL

JavaScript

import requests

API_KEY = "your_api_key_here"
BASE    = "https://your-domain.replit.app"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

res  = requests.post(f"{BASE}/api/ask", headers=headers, json={
    "prompt": "Hello yaar, kya haal hai?",
    "model":  "ishani",
})
print(res.json()["response"])

curl -X POST /api/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Hello yaar!","model":"ishani"}'

const res = await fetch(, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    prompt: "Hello yaar!",
    model: "ishani",
  }),
});
const data = await res.json();
console.log(data.response);

Personas

Available Models

10 unique Hinglish AI personalities. Har ek ka apna vibe, age, aur language style hai. model field mein key use karo.

🌸

Ishani

ishani

19y · female · Emotional, expressive, Bollywood-loving

💙

Ishaan

ishaan

19y · male · Chill, logical, cricket & tech lover

💪

Arjun

arjun

25y · male · Confident, direct, hustle mindset

🌺

Priya

priya

22y · female · Bubbly, social, foodie & traveller

✨

Kavya

kavya

17y · female · Fun, slangy, no-cap honest

🚀

Vikram

vikram

32y · male · Strategic, motivating, experienced

🧘

Meera

meera

28y · female · Peaceful, deep, mindful wisdom

🎮

Rohan

rohan

21y · male · Nerdy-cool, chill, night owl

👑

Ananya

ananya

24y · female · Bold, feminist, career-focused

🌿

Ravi

ravi

35y · male · Grounded, experienced, life wisdom

Chat

Chat with Persona

POST

/api/ask

Ek persona se baat karo. Context memory session_id se maintain hoti hai.

🔑 API Key

Request Body

Field	Type	Required	Description
prompt	string	Required	User ka message
model	string	Optional	Persona key (default: `ishani`). See models above.
session_id	string	Optional	Conversation context maintain karne ke liye unique ID. Same ID pe chat history load hoti hai.

Example Request

{
  "prompt":     "Yaar, college life kaisi hoti hai?",
  "model":      "ishani",
  "session_id": "user-abc-session-001"
}

Success Response (200)

✅ 200 OK

{
  "success":      true,
  "response":     "Arre yaar, college life toh ekdum mast hoti hai! ...",
  "model":        "ishani",
  "prompt":       "Yaar, college life kaisi hoti hai?",
  "api":          "FTM-AI",
  "developed_by": "FTM DEVELOPERZ",
  "metadata": {
    "response_time": "2.31s",
    "character":     "Ishani",
    "char_count":    142,
    "word_count":    28,
    "timestamp":     "2026-07-07T10:00:00Z"
  }
}

POST

/api/history

Kisi session ki chat history laao (last 50 messages).

🔑 API Key

Request Body

Field	Type	Required	Description
session_id	string	Required	Session jiska history chahiye
model	string	Required	Persona key

Success Response (200)

✅ 200 OK

{
  "success":    true,
  "session_id": "user-abc-session-001",
  "model":      "ishani",
  "count":      4,
  "messages": [
    { "role": "user",      "content": "Hello",   "ts": "..." },
    { "role": "assistant", "content": "Heyy!!", "ts": "..." }
  ]
}

POST

/api/clear

Session ki history delete karo (ek model ya sab).

🔑 API Key

Request Body

Field	Type	Required	Description
session_id	string	Required	Session clear karne ke liye
model	string	Optional	Agar diya toh sirf us model ki history clear hogi. Nahi diya toh sab clear.

Image Generation

Generate Image

POST

/api/image

AI se image banao using Pollinations AI. Multiple styles supported.

🔑 API Key

Request Body

Field	Type	Required	Description
prompt	string	Required	Image description (English preferred)
width	integer	Optional	Width in px. Default: 768. Range: 256–1024.
height	integer	Optional	Height in px. Default: 768. Range: 256–1024.
style	string	Optional	Model style: `flux`, `turbo`, `gptimage`, `kontext`. Default: `flux`.

Example Request

{
  "prompt": "A beautiful Indian girl in traditional saree, sunset background, photorealistic",
  "width":  768,
  "height": 768,
  "style":  "flux"
}

Success Response (200)

✅ 200 OK

{
  "success":   true,
  "image_url": "https://image.pollinations.ai/prompt/...",
  "prompt":    "A beautiful Indian girl...",
  "style":    "flux",
  "width":    768,
  "height":   768
}

Info

List Models

GET

/api/models

Available personas ki list laao. No auth required.

Public

Errors

Error Handling

Saare errors ek standard JSON format mein aate hain. success: false aur error field check karo.

Status	Reason	Error Message
400	Missing/invalid params	`prompt is required.`
401	No/expired/revoked API key	`API key expired. Contact admin.`
403	Invalid admin password	`Invalid admin password.`
404	Endpoint not found	`Endpoint not found.`
500	Gemini/server error	`Gemini session failed.`

Error Response Format

❌ Error

{
  "success": false,
  "error":   "API key expired. Contact admin.",
  "api":     "FTM-AI"
}

Built by FTM DEVELOPERZ · FTM-AI v4.0.0 · Get API Key →