Ringkasan Dokumen

Discuse memadatkan teks atau dokumen panjang menjadi ringkasan singkat dengan POST /api/v2/summarize. Kirim teks mentah (hingga 100.000 karakter) atau hingga 5 URL dokumen, dan Anda akan menerima satu summary dalam bahasa sederhana — berguna untuk memberi moderator manusia gambaran inti dari laporan, tiket, atau unggahan yang panjang sebelum mereka membaca keseluruhannya.

Kapan ringkasan berguna?

Antrean moderasi sering dipenuhi konten panjang: utas dukungan, artikel yang ditempel, PDF multi-halaman, keluhan terkait ketentuan layanan. Peninjau yang harus membaca setiap kata akan bekerja lebih lambat dan membutuhkan biaya lebih besar. Ringkasan memungkinkan moderator melakukan triase sekilas — menentukan mana yang perlu dibaca penuh dan mana yang bisa disetujui atau diteruskan dengan cepat.

Bagaimana cara meringkas konten?

Berikan salah satu dari text atau file_urls (salah satunya wajib). Dengan file_urls, Discuse mengekstrak teks dari dokumen terlebih dahulu, lalu meringkasnya.

Ringkas teks mentah

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

Ringkas dokumen

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

Respons

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

Kolom permintaan

Kolom	Tipe	Catatan
api_key	string	Opsional di body; Anda dapat mengirim X-API-Key sebagai gantinya
text	string	Teks yang akan diringkas, hingga 100.000 karakter
file_urls	string[]	URL dokumen yang akan dibaca dan diringkas, hingga 5

Berikan salah satu dari text atau file_urls. Jika Anda mengirim keduanya, text akan digunakan.

Kolom respons

Kolom	Tipe	Deskripsi
summary	string	Ringkasan yang dihasilkan
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

Batas penggunaan

Ringkasan adalah fitur paket berbayar; setiap ringkasan dihitung satu kali terhadap kuota ringkasan dokumen Anda.

Paket	Ringkasan Bulanan	Tarif Kelebihan
Basic	Tidak tersedia	-
Gold	100	$0.02/ringkasan
Platinum	500	$0.017/ringkasan (diskon 15%)
Ultimate	2,000	$0.015/ringkasan (diskon 25%)

Jika sebuah proyek tidak memiliki langganan aktif, permintaan ringkasan akan ditolak.

Praktik terbaik

Ringkas untuk triase, bukan untuk mengambil keputusan

Ringkasan adalah alat bantu baca bagi peninjau manusia, bukan putusan moderasi. Gunakan untuk memprioritaskan antrean, lalu jalankan konten asli melalui POST /api/v2/check (atau lakukan moderasi saat OCR) untuk keputusan kebijakan yang sebenarnya.

Padukan dengan OCR untuk dokumen hasil pemindaian

file_urls sudah menjalankan OCR sebelum meringkas, jadi PDF hasil pemindaian atau gambar berisi teks dapat langsung digunakan — tidak perlu panggilan OCR terpisah.

Patuhi batas panjang

text dibatasi hingga 100.000 karakter. Untuk materi sumber yang lebih panjang, ringkas per bagian lalu gabungkan, atau kirim dokumen sebagai URL.

Contoh integrasi

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

Siap mempercepat antrean peninjauan Anda? Mulai gunakan Discuse.