Belge Özetleme

Discuse, uzun metinleri veya belgeleri POST /api/v2/summarize ile kısa bir özete dönüştürür. Ham metin (100.000 karaktere kadar) veya en fazla 5 belge URL’si gönderin; karşılığında tek bir sade dilli summary alırsınız. Bu, insan moderatörlere uzun bir raporu, talebi veya yüklemeyi tamamını okumadan önce genel hatlarıyla aktarmak için kullanışlıdır.

Özetleme ne zaman işe yarar?

Moderasyon kuyrukları uzun içeriklerle dolar: destek yazışmaları, yapıştırılmış makaleler, çok sayfalı PDF’ler, hizmet şartlarıyla ilgili şikâyetler. Her kelimeyi okumak zorunda olan bir inceleyici yavaş ilerler ve maliyetlidir. Özet, moderatörün bir bakışta ön değerlendirme yapmasını sağlar — neyin baştan sona okunması gerektiğine, neyin hızlıca onaylanabileceğine veya yönlendirilebileceğine karar verebilir.

İçeriği nasıl özetlerim?

text veya file_urls alanlarından birini sağlayın (biri zorunludur). file_urls kullanıldığında Discuse önce belgelerden metni çıkarır, ardından özetler.

Ham metni özetleme

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..."
  }'

Belgeleri özetleme

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"]
  }'

Yanıt

{
  "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
  }
}

İstek alanları

Alan	Tür	Notlar
api_key	string	Gövdede isteğe bağlıdır; bunun yerine X-API-Key gönderebilirsiniz
text	string	Özetlenecek metin, 100.000 karaktere kadar
file_urls	string[]	Okunup özetlenecek belge URL’leri, en fazla 5

text veya file_urls alanlarından birini sağlayın. İkisini de gönderirseniz text kullanılır.

Yanıt alanları

Alan	Tür	Açıklama
summary	string	Oluşturulan özet
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

Kullanım sınırları

Özetleme, ücretli planlara dahil bir özelliktir; her özet, belge özeti kotanızdan bir kez düşülür.

Plan	Aylık Özet Sayısı	Aşım Ücreti
Basic	Kullanılamaz	-
Gold	100	$0.02/summary
Platinum	500	$0.017/summary (15% discount)
Ultimate	2,000	$0.015/summary (25% discount)

Bir projenin aktif aboneliği yoksa özetleme istekleri reddedilir.

En iyi uygulamalar

Karar vermek için değil, ön değerlendirme için özetleyin

Özet, insan inceleyiciler için bir okuma yardımcısıdır; moderasyon kararı değildir. Kuyruğu önceliklendirmek için kullanın, ardından asıl politika kararı için orijinal içeriği POST /api/v2/check üzerinden geçirin (veya OCR sırasında moderasyon yapın).

Taranmış belgeler için OCR ile birlikte kullanın

file_urls, özetlemeden önce zaten OCR çalıştırır; bu nedenle taranmış bir PDF veya metin içeren bir görsel doğrudan çalışır — ayrı bir OCR çağrısına gerek yoktur.

Uzunluk sınırına uyun

text 100.000 karakterle sınırlıdır. Daha uzun kaynak materyaller için bölümler hâlinde özetleyip birleştirin veya belgeyi URL olarak gönderin.

Entegrasyon örnekleri

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()

İnceleme kuyruğunuzu hızlandırmaya hazır mısınız? Discuse ile başlayın.