ব্যাচ এন্ডপয়েন্ট একটি একক POST-এ Telm অ্যান্টি-স্প্যাম ইঞ্জিন দিয়ে 20টি পর্যন্ত টেক্সট চালায়, প্রতিটির জন্য একটি রায় ফেরত দেয়। এটি শুধু-নিয়ম (কোনো AI স্তর নেই) এবং Pro প্ল্যান ও উচ্চতরে উপলব্ধ। কোটা প্রতি আইটেমে ধার্য হয়, তাই দশটি টেক্সটের একটি ব্যাচ দশটি কল খরচ করে। একটি ঐচ্ছিক AI চেকসহ একটি একক টেক্সটের জন্য, নিয়মিত স্প্যাম-চেক এন্ডপয়েন্ট ব্যবহার করুন।
1ব্যাচ স্প্যাম চেক কী করে
ব্যাচ স্প্যাম চেক আপনাকে প্রতি বার্তায় একটি অনুরোধ করার বদলে একসঙ্গে অনেক টেক্সট স্কোর করতে দেয়। আপনি /spam/check-batch-এ একটি আইটেম অ্যারেসহ একটি POST পাঠান এবং একই ক্রমে রায়ের একটি অ্যারে ফেরত পান — বার্তার একটি ব্যাকলগ শ্রেণিবদ্ধ করা, একটি কমেন্ট ফিড মডারেট করা, বা একটি নমুনার উপর শনাক্তকরণের মান মূল্যায়নের জন্য আদর্শ।
ব্যাচ সেই একই নিয়ম ইঞ্জিন চালায় যা লাইভ গ্রুপ রক্ষা করে, কিন্তু এটি AI স্তর চালায় না, যা প্রতিটি অনুরোধ দ্রুত ও অনুমেয় রাখে। AI চেক দরকার হলে, AI অপশন চালু করে একক স্প্যাম-চেক এন্ডপয়েন্ট ব্যবহার করুন, একবারে একটি টেক্সট।
- এন্ডপয়েন্ট: POST /api/public/v1/spam/check-batch।
- প্রতি অনুরোধে 20টি পর্যন্ত টেক্সট স্কোর করে, রায় ইনপুট ক্রমে ফেরত।
- শুধু-নিয়ম: ব্যাচ মোডে AI স্তর চলে না।
2অনুরোধ ফরম্যাট
অনুরোধ বডি একটি items অ্যারেসহ একটি JSON অবজেক্ট। প্রতিটি আইটেমে একটি আবশ্যক text ফিল্ড এবং একটি ঐচ্ছিক context অবজেক্ট থাকে যা লাইভ ইঞ্জিন যা দেখে তার প্রতিফলন — group_id, প্রেরকের user_telegram_id, প্রেরক নতুন ব্যবহারকারী কিনা, username, এবং allow_sales ও crypto_community-এর মতো ফ্ল্যাগ।
একটি আইটেম তার context-এ একটি group_id অন্তর্ভুক্ত করলে চেকটি সেই গ্রুপের কাস্টম নিয়ম ও সেটিংস প্রয়োগ করে, তাই আপনার অ্যাকাউন্টকে সেই গ্রুপের একজন অ্যাডমিন হতে হবে নইলে পুরো অনুরোধ প্রত্যাখ্যাত হয়। বদলে বৈশ্বিক নিয়মসেটের বিপরীতে স্কোর করতে গ্রুপ context বাদ দিন।
- শীর্ষ-স্তরের ফিল্ড: items — এক থেকে বিশটি এন্ট্রির একটি অ্যারে।
- প্রতিটি আইটেম: text (আবশ্যক) এবং একটি ঐচ্ছিক context অবজেক্ট।
- Context বহন করতে পারে group_id, user_telegram_id, is_new_user, username, allow_sales, crypto_community।
- একটি গ্রুপ context-এর জন্য আপনাকে সেই গ্রুপ পরিচালনা করতে হবে।
3সাড়া ফরম্যাট
সাড়া হলো একটি results অ্যারেসহ একটি JSON অবজেক্ট — প্রতি ইনপুট আইটেমে একটি রায়, একই ক্রমে — এবং একটি quota অবজেক্ট যা আপনার used কাউন্ট, দৈনিক সীমা ও রিসেট সময় দেখায়।
প্রতিটি রায় আপনাকে শ্রেণিবিন্যাস ও কারণ বলে। verdict ফিল্ডটি spam, suspicious বা clean-এর একটি। এর পাশাপাশি আপনি একটি সাংখ্যিক score ও confidence, একটি recommended_action (none, review, warn, mute, kick, ban বা delete-এর একটি), categories-এর একটি তালিকা, সহজবোধ্য reasons, matched_rules-এর নাম, এবং প্রতিটি স্কোরিং অবদানসহ একটি signals ম্যাপ পান।
- results — প্রতি আইটেমে একটি রায়, ইনপুট ক্রমে।
- verdict — spam, suspicious বা clean।
- প্রতিটি রায়ে আরও থাকে score, confidence, recommended_action, categories, reasons, matched_rules ও signals।
- quota — used, limit ও reset_at, বডিতে প্রতিধ্বনিত।
4সীমা ও কোটা খরচ
একটি ব্যাচ প্রতি অনুরোধে 20 আইটেমে সীমিত, এবং প্রতিটি টেক্সট 10,000 অক্ষরে সীমিত। পুরো অনুরোধ বডিরও একটি আকার সীমা আছে, তাই খুব বড় পেলোড প্রসেসিংয়ের আগে প্রত্যাখ্যাত হয়। 20টির বেশি টেক্সট থাকলে সেগুলো কয়েকটি অনুরোধে ভাগ করুন।
কোটা প্রতি আইটেমে ধার্য হয়, প্রতি অনুরোধে নয়: দশটি টেক্সটের একটি ব্যাচ আপনার দৈনিক কোটা থেকে দশটি কল খরচ করে। এটি API রেট লিমিট ও কোটায় বর্ণিত একই বাজেট, এবং সাড়া স্বাভাবিক X-Quota-Limit, X-Quota-Used ও X-Quota-Reset হেডার বহন করে।
- প্রতি অনুরোধে 20টি পর্যন্ত আইটেম; প্রতি টেক্সটে 10,000টি পর্যন্ত অক্ষর।
- কোটা খরচ ব্যাচের আইটেম সংখ্যার সমান।
- স্ট্যান্ডার্ড X-Quota-* হেডার প্রযোজ্য, সঙ্গে বডিতে একটি quota অবজেক্ট।
5ত্রুটি ও টাইমআউট
খারাপ অনুরোধ একটি নির্দিষ্ট কোডসহ 400 ফেরত দেয়: একটি খালি items অ্যারে, আইটেম সীমার বেশি একটি ব্যাচ, একটি অনুপস্থিত text, বা দৈর্ঘ্য সীমার বেশি একটি text। আপনি পরিচালনা করেন না এমন একটি গ্রুপ context সেই আইটেমের জন্য 404 ফেরত দেয়। Pro-এর নিচের একটি প্ল্যান একটি plan_required কোডসহ 403 ফেরত দেয়।
একটি ব্যাচ প্রসেস করতে তার সময় বাজেট অতিক্রম করলে, API 504 ফেরত দেয় এবং যে আইটেমগুলো এটি শেষ করেনি সেগুলোর কোটা ফেরত দেয়, তাই আপনি কেবল সম্পন্ন কাজের জন্য ধার্য হন। টাইমআউট দেখলে ছোট ব্যাচ পাঠান।
- 400 — empty_batch, batch_too_large, missing_text বা text_too_long।
- 404 — একটি আইটেম context-এর একটি গ্রুপ আপনি পরিচালনা করেন না।
- 403 plan_required — ব্যাচ এন্ডপয়েন্টের Pro বা উচ্চতর দরকার।
- 504 timeout — ব্যাচ বেশি সময় চলেছে; অসম্পূর্ণ আইটেম ফেরত দেওয়া হয়। কম টেক্সট পাঠান।