Resumen de documentos

Discuse condensa textos largos o documentos en un resumen breve con POST /api/v2/summarize. Envía texto sin procesar (hasta 100,000 caracteres) o hasta 5 URL de documentos, y recibirás un único summary en lenguaje sencillo, útil para que los moderadores humanos capten la idea general de un informe, ticket o archivo subido extenso antes de leerlo completo.

¿Cuándo resulta útil el resumen?

Las colas de moderación se llenan de contenido largo: hilos de soporte, artículos pegados, PDF de varias páginas, quejas sobre términos de servicio. Un revisor que tiene que leer cada palabra avanza lento y cuesta más. Un resumen permite que un moderador haga una clasificación inicial de un vistazo: decidir qué necesita una lectura completa y qué puede aprobarse o derivarse rápidamente.

¿Cómo resumo contenido?

Proporciona text o file_urls (uno de los dos es obligatorio). Con file_urls, Discuse primero extrae el texto de los documentos y luego lo resume.

Resumir texto sin procesar

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

Resumir documentos

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

Respuesta

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

Campos de la solicitud

Campo	Tipo	Notas
api_key	string	Opcional en el cuerpo; también puedes enviar X-API-Key
text	string	Texto que se va a resumir, hasta 100,000 caracteres
file_urls	string[]	URL de documentos que se leerán y resumirán, hasta 5

Proporciona uno de estos: text o file_urls. Si envías ambos, se usa text.

Campos de la respuesta

Campo	Tipo	Descripción
summary	string	El resumen generado
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

Límites de uso

El resumen es una función de planes de pago; cada resumen cuenta una vez contra tu cuota de resúmenes de documentos.

Plan	Resúmenes mensuales	Tarifa por exceso
Basic	No disponible	-
Gold	100	$0.02/resumen
Platinum	500	$0.017/resumen (15% de descuento)
Ultimate	2,000	$0.015/resumen (25% de descuento)

Si un proyecto no tiene una suscripción activa, las solicitudes de resumen se deniegan.

Buenas prácticas

Resume para clasificar, no para decidir

Un resumen es una ayuda de lectura para revisores humanos, no un veredicto de moderación. Úsalo para priorizar la cola y luego procesa el contenido original con POST /api/v2/check (o modéralo durante OCR) para tomar la decisión real según la política.

Combínalo con OCR para documentos escaneados

file_urls ya ejecuta OCR antes de resumir, por lo que un PDF escaneado o una imagen con texto funciona directamente, sin necesidad de una llamada OCR separada.

Respeta el límite de longitud

text tiene un límite de 100,000 caracteres. Para material de origen más largo, resume por secciones y combínalas, o pasa el documento como una URL.

Ejemplos de integración

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

¿Listo para acelerar tu cola de revisión? Empieza con Discuse.