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.