خلاصه‌سازی سند

Discuse متن‌ها یا اسناد طولانی را با POST /api/v2/summarize به یک خلاصه کوتاه تبدیل می‌کند. متن خام (تا ۱۰۰٬۰۰۰ نویسه) یا حداکثر ۵ URL سند را ارسال کنید و در پاسخ یک summary ساده و قابل‌فهم دریافت می‌کنید — مناسب برای اینکه ناظران انسانی پیش از خواندن کامل یک گزارش، تیکت یا فایل بارگذاری‌شده طولانی، دیدی کلی از محتوای آن داشته باشند.

خلاصه‌سازی چه زمانی کاربرد دارد؟

صف‌های بررسی محتوا معمولاً با محتوای طولانی پر می‌شوند: گفت‌وگوهای پشتیبانی، مقاله‌های کپی‌شده، PDFهای چندصفحه‌ای، شکایت‌های مربوط به شرایط استفاده از خدمات. بازبینی‌کننده‌ای که مجبور باشد تک‌تک کلمات را بخواند، کند و پرهزینه عمل می‌کند. خلاصه به ناظر کمک می‌کند در یک نگاه اولویت‌بندی کند — تصمیم بگیرد کدام مورد به مطالعه کامل نیاز دارد و کدام را می‌توان سریع تأیید یا به مسیر مناسب ارجاع داد.

چگونه محتوا را خلاصه کنم؟

یا 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	متنی که باید خلاصه شود، تا ۱۰۰٬۰۰۰ نویسه
file_urls	string[]	URLهای اسنادی که باید خوانده و خلاصه شوند، تا ۵ مورد

یکی از text یا file_urls را ارائه دهید. اگر هر دو را ارسال کنید، از text استفاده می‌شود.

فیلدهای پاسخ

فیلد	نوع	توضیح
summary	string	خلاصه تولیدشده
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

محدودیت‌های استفاده

خلاصه‌سازی قابلیتی مخصوص طرح‌های پولی است؛ هر خلاصه یک‌بار از سهمیه خلاصه‌سازی سند شما کم می‌کند.

طرح	خلاصه‌های ماهانه	نرخ مصرف مازاد
Basic	در دسترس نیست	-
Gold	۱۰۰	$0.02/summary
Platinum	۵۰۰	$0.017/summary (۱۵٪ تخفیف)
Ultimate	۲٬۰۰۰	$0.015/summary (۲۵٪ تخفیف)

اگر پروژه‌ای اشتراک فعال نداشته باشد، درخواست‌های خلاصه‌سازی رد می‌شوند.

بهترین روش‌ها

برای اولویت‌بندی خلاصه کنید، نه برای تصمیم‌گیری

خلاصه ابزاری کمکی برای مطالعه توسط بازبینی‌کنندگان انسانی است، نه حکم نهایی درباره نظارت محتوا. از آن برای اولویت‌بندی صف استفاده کنید، سپس محتوای اصلی را برای تصمیم واقعی مطابق سیاست‌ها از طریق POST /api/v2/check اجرا کنید (یا هنگام OCR آن را بررسی کنید).

برای اسناد اسکن‌شده با OCR همراه کنید

file_urls پیش از خلاصه‌سازی، OCR را به‌صورت خودکار اجرا می‌کند؛ بنابراین PDF اسکن‌شده یا تصویری از متن مستقیماً کار می‌کند — نیازی به فراخوانی جداگانه OCR نیست.

سقف طول را رعایت کنید

text حداکثر ۱۰۰٬۰۰۰ نویسه را می‌پذیرد. برای محتوای منبع طولانی‌تر، آن را بخش‌بندی و خلاصه‌ها را ترکیب کنید، یا سند را به‌صورت 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.