API_DOCS.md

# 📚 Cipher-MD API Documentation

මෙම ලේඛනයේ දැක්වෙන්නේ `Cipher-MD API Bundle` එකේ ඇති සියලුම APIs භාවිතා කරන ආකාරය සහ ඒවාට යැවිය යුතු Parameters පිළිබඳ සම්පූර්ණ විස්තරයයි.

**Main Base URL:** `https://sh4lu-z-cipher-md-api.hf.space`

---

## 🟢 1. Visuals Engine
**Base URL:** `/visuals` *(Legacy Alias: `/biologic`)*

මෙම සර්වර් එකෙන් Images (Welcome, Watermark, Stickers) සහ Trading Charts ජෙනරේට් කිරීම සිදු කරයි.

### 1.1 Welcome Image Generator
* **Endpoint:** `POST /visuals/welcome` *(හෝ `POST /biologic/welcome`)*
* **Type:** `multipart/form-data`
* **Parameters:**
  * `image` (File) - Profile Picture එක (අනිවාර්යයි)
  * `title` (Text) - Group එකේ නම (Optional)
  * `count` (Text) - Member අංකය (Optional)
  * `userName` (Text) - Member ගේ නම (Optional)
  * `style` (Text/Number) - Style ID (1 - 10) (Optional - නොදුන්නොත් random)
* **Response:** PNG Image (`image/png`)

### 1.2 Add Watermark
* **Endpoint:** `POST /visuals/watermark` *(හෝ `POST /biologic/watermark`)*
* **Type:** `multipart/form-data`
* **Parameters (1):**
  * `image` (File) - Watermark එක ගහන්න ඕන ෆොටෝ එක (අනිවාර්යයි)
* **Response:** PNG Image (`image/png`)

### 1.3 Add Advanced Stealth Watermark (Ghost Watermark)
* **Endpoint:** `POST /visuals/watermark/advanced` *(හෝ `POST /visuals/watermark/stealth`, `POST /scanner/advanced`)*
* **Type:** `multipart/form-data`
* **Parameters (1):**
  * `image` (File) - Stealth watermark එක ගහන්න ඕන ෆොටෝ එක (අනිවාර්යයි)
* **විස්තරය:** ඇසට නොපෙනෙන 2% Opacity එකෙන් Zig-Zag "CIPHER-MD" රටාවක් සහ EXIF Camera Metadata එකතු කරයි. මෙම Watermark එක හඳුනාගත හැක්කේ `/scanner/scan` මඟින් පමණි.
* **Response:** Watermarked Image File (`image/jpeg` / `image/png`)

### 1.4 Add Video Visible Watermark
* **Endpoint:** `POST /visuals/watermark/video` *(හෝ `POST /visuals/watermark/video/visible`)*
* **Type:** `multipart/form-data`
* **Parameters:**
  * `video` (File) - MP4/MKV video file (අනිවාර්යයි)
  * `text` (Text) - Watermark text එක (Default: `CIPHER-MD`)
  * `position` (Text) - `bottom_right`, `bottom_left`, `top_right`, `top_left`, `center` (Default: `bottom_right`)
  * `watermark_image` (File) - Custom PNG logo overlay (Optional)
* **Response:** Watermarked Video File (`video/mp4`)

### 1.5 Add Video Stealth (Invisible) Watermark
* **Endpoint:** `POST /visuals/watermark/video/stealth` *(හෝ `POST /visuals/watermark/video/invisible`)*
* **Type:** `multipart/form-data`
* **Parameters:**
  * `video` (File) - MP4/MKV video file (අනිවාර්යයි)
  * `text` (Text) - Stealth watermark text (Default: `CIPHER-MD`)
  * `method` (Text) - `hybrid` (visual 2% + metadata), `visual` (2% frame overlay), `metadata` (instant zero re-encode)
* **Response:** Stealth Protected Video File (`video/mp4`)

### 1.6 Scan Video Watermark
* **Endpoint:** `POST /scanner/scan/video` *(හෝ `POST /scan/video`)*
* **Type:** `multipart/form-data`
* **Parameters:**
  * `video` (File) - Scan කරන්න ඕන video file එක (අනිවාර්යයි)
* **Response:** Revealed frame PNG (`image/png`) with `X-Stealth-Metadata` header

### 1.7 Candle Chart Generator
* **Endpoint:** `POST /visuals/chart/candle`
* **Type:** `application/json`
* **Parameters JSON:**
  * `candles` (Array) - `[{open, high, low, close, volume}, ...]`
  * `symbol` (Text) - Coin එකේ නම (උදා: BTC)
  * `change` (Text) - වෙනස් වුණු ප්‍රතිශතය
  * `currentPrice` (Text/Number) - දැනට තියෙන ගාණ
* **Response:** PNG Image (`image/png`)

*(මෙයට අමතරව `/chart/nft`, `/chart/arb`, `/chart/p2p`, `/chart/forex`, `/chart/gold`, `/chart/cse`, `/chart/fear` යන endpoints සඳහාද අදාළ JSON History Data යැවිය යුතුය.)*

---

## 🎵 2. Audio Engine
**Base URL:** `/audio` *(Legacy Alias: `/audio_server`)*

මෙම සර්වර් එකෙන් Audios වලට විවිධ DJ Effects (Bass, 8D, Nightcore) එකතු කිරීම සිදු කරයි.

### 2.1 Process Audio Effect
* **Endpoint:** `POST /audio/process` *(හෝ `POST /audio_server/process`)*
* **Type:** `multipart/form-data`
* **Parameters (3):**
  * `file` (File) - Audio File එක (MP3/WAV) (අනිවාර්යයි)
  * `effect` (Text) - Effect එකේ නම. (උදා: `bass_studio`, `bass_edm`, `bass_car`, `8d_audio`, `vocal_boost`, `nightcore`, `slow_reverb`, `vaporwave`) (අනිවාර්යයි)
  * `level` (Number) - Effect එකේ සැර (උදා: `10`)
* **Response:** MP3 Audio File (`audio/mpeg`)

---

## 🎬 3. Sticker API
**Base URL:** `/sticker` *(Legacy Aliases: `/cipher_sticker`, `/cipher`)*

මෙම සර්වර් එකෙන් Videos වලින් Animated Stickers සහ Sticker Packs සෑදීම සිදු කරයි (Size එක 1MB වලට අඩුවෙන්).

### 3.1 Make Single Sticker
* **Endpoint:** `POST /sticker` *(Legacy Aliases: `POST /sticker/sticker`, `POST /cipher_sticker/sticker`)*
* **Type:** `multipart/form-data`
* **Parameters (1):**
  * `file` (File) - Video/GIF/Image එක (අනිවාර්යයි)
* **Response:** WebP Sticker (`image/webp`)

### 3.2 Make Sticker Pack (ZIP)
* **Endpoint:** `POST /sticker/pack` *(හෝ `POST /cipher_sticker/pack`)*
* **Type:** `multipart/form-data`
* **Parameters (1):**
  * `file` (File) - දිග Video එකක් (උපරිම විනාඩි 2) (අනිවාර්යයි)
* **Response:** ZIP File (`application/zip`) - කොටස් වලට කැඩූ Stickers ගොන්නක්.

---

## 🧮 4. Watermark Scanner
**Base URL:** `/scanner` *(Legacy Aliases: `/scan`, `/math`)*

මෙම සර්වර් එකෙන් ෆොටෝ වල ඇති Watermark අයින් කිරීම/බැලීම සිදු කරයි.

### 4.1 Scan / Reveal Watermark
* **Endpoint:** `POST /scanner/scan` *(හෝ `POST /scan/scan`, `POST /math/scan`)*
* **Type:** `multipart/form-data`
* **Parameters (1):**
  * `image` (File) - Watermark එක තියෙන ෆොටෝ එක (අනිවාර්යයි)
* **Response:** Image File (කලින් නොපෙනුණු Watermark එක මතු කළ ෆොටෝව)

---
*Created by Antigravity for Cipher-MD API Gateway.*