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

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

1.1 Welcome Image Generator

• Endpoint: POST /visuals/welcome
• Type: multipart/form-data
• Parameters (3):
  • image (File) - Profile Picture එක (අනිවාර්යයි)
  • title (Text) - Group එකේ නම (Optional)
  • count (Text) - Member අංකය (Optional)
• Response: PNG Image (image/png)

1.2 Add Watermark

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

1.3 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 Server

Base URL: /audio_server

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

2.1 Process Audio Effect

• Endpoint: 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. Cipher Sticker API

Base URL: /cipher_sticker

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

3.1 Make Single Sticker

• Endpoint: 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 /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

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

4.1 Scan / Reveal Watermark

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

---

Created by Antigravity for Cipher-MD API Gateway.