Resumo de documentos

Discuse condensa textos longos ou documentos em um breve resumo com POST /api/v2/summarize. Envie texto bruto (até 100.000 caracteres) ou até 5 URLs de documentos, e você recebe de volta um único summary em linguagem simples — útil para dar a moderadores humanos uma noção geral de um relatório, ticket ou upload extenso antes de lerem tudo.

Quando o resumo é útil?

Filas de moderação ficam cheias de conteúdos longos: conversas de suporte, artigos colados, PDFs com várias páginas, reclamações sobre termos de serviço. Um revisor que precisa ler cada palavra trabalha de forma lenta e cara. Um resumo permite que um moderador faça uma triagem rápida — decidindo o que precisa de uma leitura completa e o que pode ser aprovado ou encaminhado rapidamente.

Como resumir conteúdo?

Forneça text ou file_urls (um dos dois é obrigatório). Com file_urls, Discuse primeiro extrai o texto dos documentos e depois o resume.

Resumir texto bruto

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

Resposta

{
  "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 da solicitação

Campo	Tipo	Observações
api_key	string	Opcional no corpo; você também pode enviar X-API-Key
text	string	Texto a ser resumido, até 100.000 caracteres
file_urls	string[]	URLs de documentos a serem lidos e resumidos, até 5

Forneça um dos dois: text ou file_urls. Se você enviar ambos, text será usado.

Campos da resposta

Campo	Tipo	Descrição
summary	string	O resumo gerado
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

Limites de uso

O resumo é um recurso de planos pagos; cada resumo conta uma vez na sua cota de resumos de documentos.

Plano	Resumos mensais	Taxa por excedente
Basic	Não disponível	-
Gold	100	$0.02/resumo
Platinum	500	$0.017/resumo (15% de desconto)
Ultimate	2,000	$0.015/resumo (25% de desconto)

Se um projeto não tiver uma assinatura ativa, as solicitações de resumo serão negadas.

Boas práticas

Resuma para fazer triagem, não para decidir

Um resumo é um auxílio de leitura para revisores humanos, não um veredito de moderação. Use-o para priorizar a fila e, em seguida, envie o conteúdo original para POST /api/v2/check (ou modere durante o OCR) para a decisão real de política.

Combine com OCR para documentos escaneados

file_urls já executa OCR antes de resumir, portanto um PDF escaneado ou uma imagem com texto funciona diretamente — sem precisar de uma chamada OCR separada.

Respeite o limite de tamanho

text é limitado a 100.000 caracteres. Para materiais de origem mais longos, resuma em seções e combine os resultados, ou passe o documento como uma URL.

Exemplos de integração

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

Pronto para acelerar sua fila de revisão? Comece com Discuse.