Résumé de documents

Discuse condense de longs textes ou documents en un court résumé avec POST /api/v2/summarize. Envoyez du texte brut (jusqu’à 100 000 caractères) ou jusqu’à 5 URL de documents, et vous recevez un summary unique en langage clair — pratique pour donner aux modérateurs humains l’essentiel d’un long signalement, ticket ou fichier importé avant qu’ils ne le lisent en entier.

Quand le résumé est-il utile ?

Les files de modération se remplissent de contenus longs : fils de support, articles copiés-collés, PDF de plusieurs pages, réclamations liées aux conditions d’utilisation. Un évaluateur qui doit lire chaque mot est lent et coûteux. Un résumé permet à un modérateur de faire un premier tri en un coup d’œil — décider ce qui nécessite une lecture complète et ce qui peut être validé ou orienté rapidement.

Comment résumer du contenu ?

Fournissez soit text, soit file_urls (l’un des deux est obligatoire). Avec file_urls, Discuse extrait d’abord le texte des documents, puis le résume.

Résumer du texte brut

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

Résumer des documents

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

Réponse

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

Champs de la requête

Champ	Type	Remarques
api_key	string	Facultatif dans le corps ; vous pouvez envoyer X-API-Key à la place
text	string	Texte à résumer, jusqu’à 100 000 caractères
file_urls	string[]	URL des documents à lire et à résumer, jusqu’à 5

Fournissez l’un des deux champs, text ou file_urls. Si vous envoyez les deux, text est utilisé.

Champs de la réponse

Champ	Type	Description
summary	string	Le résumé généré
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

Limites d’utilisation

Le résumé est une fonctionnalité réservée aux offres payantes ; chaque résumé est décompté une fois de votre quota de résumés de documents.

Offre	Résumés mensuels	Tarif de dépassement
Basic	Non disponible	-
Gold	100	$0.02/résumé
Platinum	500	$0.017/résumé (15 % de remise)
Ultimate	2,000	$0.015/résumé (25 % de remise)

Si un projet ne dispose d’aucun abonnement actif, les requêtes de résumé sont refusées.

Bonnes pratiques

Résumer pour trier, pas pour décider

Un résumé est une aide à la lecture pour les évaluateurs humains, pas une décision de modération. Utilisez-le pour prioriser la file, puis soumettez le contenu original à POST /api/v2/check (ou modérez pendant l’OCR) pour prendre la véritable décision d’application des règles.

Associer avec OCR pour les documents numérisés

file_urls exécute déjà OCR avant de résumer ; un PDF numérisé ou une image contenant du texte fonctionne donc directement — aucun appel OCR séparé n’est nécessaire.

Respecter la limite de longueur

text est limité à 100 000 caractères. Pour des sources plus longues, résumez par sections puis combinez les résultats, ou fournissez le document sous forme d’URL.

Exemples d’intégration

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

Prêt à accélérer votre file de vérification ? Démarrez avec Discuse.