दस्तावेज़ सारांशीकरण

Discuse लंबे टेक्स्ट या दस्तावेज़ों को POST /api/v2/summarize के ज़रिए छोटे सारांश में बदल देता है। कच्चा टेक्स्ट (100,000 अक्षरों तक) या अधिकतम 5 दस्तावेज़ URLs भेजें, और बदले में आपको सरल भाषा में एक summary मिलता है — यह मानव मॉडरेटरों को पूरी चीज़ पढ़ने से पहले किसी लंबी रिपोर्ट, टिकट या अपलोड का सार समझाने में उपयोगी है।

सारांशीकरण कब उपयोगी होता है?

मॉडरेशन कतारें अक्सर लंबे कंटेंट से भर जाती हैं: सपोर्ट थ्रेड, पेस्ट किए गए लेख, कई पन्नों वाले PDFs, सेवा-शर्तों से जुड़ी शिकायतें। हर शब्द पढ़ने वाला रिव्यूअर धीमा भी पड़ता है और महंगा भी होता है। सारांश की मदद से मॉडरेटर एक नज़र में छंटाई कर सकता है — तय कर सकता है कि किसे पूरा पढ़ना ज़रूरी है और किसे जल्दी मंज़ूर या आगे भेजा जा सकता है।

मैं कंटेंट का सारांश कैसे बनाऊँ?

या तो text दें या file_urls (इनमें से एक अनिवार्य है)। file_urls के साथ, Discuse पहले दस्तावेज़ों से टेक्स्ट निकालता है, फिर उसका सारांश बनाता है।

कच्चे टेक्स्ट का सारांश बनाएँ

curl -X POST https://api.discuse.com/api/v2/summarize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "text": "Long support thread or article text here..."
  }'

दस्तावेज़ों का सारांश बनाएँ

curl -X POST https://api.discuse.com/api/v2/summarize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "file_urls": ["https://example.com/user-report.pdf"]
  }'

प्रतिक्रिया

{
  "summary": "A user reports repeated harassment from another account over three days, including direct messages and comments. They have screenshots and request the account be reviewed.",
  "usage": {
    "api_requests_used": 87,
    "api_requests_limit": 500,
    "api_requests_remaining": 413
  }
}

अनुरोध फ़ील्ड

फ़ील्ड	प्रकार	नोट्स
api_key	string	बॉडी में वैकल्पिक; इसकी जगह आप X-API-Key भेज सकते हैं
text	string	सारांश बनाने के लिए टेक्स्ट, 100,000 अक्षरों तक
file_urls	string[]	पढ़ने और सारांश बनाने के लिए दस्तावेज़ URLs, अधिकतम 5

text या file_urls में से एक दें। अगर आप दोनों भेजते हैं, तो text का उपयोग किया जाता है।

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
summary	string	बनाया गया सारांश
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

उपयोग सीमाएँ

सारांशीकरण paid-plan सुविधा है; प्रत्येक सारांश आपकी document-summary quota में एक बार गिना जाता है।

प्लान	मासिक सारांश	अतिरिक्त उपयोग दर
Basic	उपलब्ध नहीं	-
Gold	100	$0.02/सारांश
Platinum	500	$0.017/सारांश (15% छूट)
Ultimate	2,000	$0.015/सारांश (25% छूट)

अगर किसी प्रोजेक्ट में सक्रिय सब्सक्रिप्शन नहीं है, तो सारांश अनुरोध अस्वीकार कर दिए जाते हैं।

सर्वोत्तम तरीके

सारांश का उपयोग छंटाई के लिए करें, निर्णय के लिए नहीं

सारांश मानव रिव्यूअर के लिए पढ़ने में मदद करने वाला साधन है, मॉडरेशन का अंतिम फैसला नहीं। इसका उपयोग कतार को प्राथमिकता देने के लिए करें, फिर वास्तविक नीति निर्णय के लिए मूल कंटेंट को POST /api/v2/check से गुज़ारें (या OCR के दौरान मॉडरेट करें)।

स्कैन किए गए दस्तावेज़ों के लिए OCR के साथ उपयोग करें

file_urls सारांश बनाने से पहले अपने-आप OCR चलाता है, इसलिए स्कैन किया हुआ PDF या टेक्स्ट वाली इमेज सीधे काम करती है — अलग से OCR कॉल करने की ज़रूरत नहीं होती।

लंबाई सीमा का ध्यान रखें

text की सीमा 100,000 अक्षर है। इससे लंबे स्रोत सामग्री के लिए, हिस्सों में सारांश बनाएँ और उन्हें मिलाएँ, या दस्तावेज़ को URL के रूप में पास करें।

इंटीग्रेशन उदाहरण

Node.js

async function summarize({ text, fileUrls }) {
  const response = await fetch('https://api.discuse.com/api/v2/summarize', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.DISCUSE_API_KEY
    },
    body: JSON.stringify(text ? { text } : { file_urls: fileUrls })
  });
  return response.json();
}

Python

import os
import requests

def summarize(text=None, file_urls=None):
    payload = {'text': text} if text else {'file_urls': file_urls}
    response = requests.post(
        'https://api.discuse.com/api/v2/summarize',
        headers={
            'Content-Type': 'application/json',
            'X-API-Key': os.environ['DISCUSE_API_KEY']
        },
        json=payload
    )
    return response.json()

अपनी रिव्यू कतार को तेज़ करने के लिए तैयार हैं? Discuse के साथ शुरुआत करें.