Compare API

POST /v1/compare

Compare deux textes sémantiquement et retourne un score de similarité, un résumé des différences et les thèmes communs.

Paramètres

Exemple

Requête

{
  "text1": "L'IA générative permet de créer du contenu textuel, visuel et audio à partir de simples instructions. Elle est utilisée dans le marketing, l'éducation et la recherche.",
  "text2": "Les modèles de langage comme GPT et Llama génèrent du texte de haute qualité. Ils sont particulièrement utiles pour la rédaction automatique et l'assistance à la recherche.",
  "lang": "fr"
}

Réponse

{
  "similarity_score": 0.72,
  "summary": "Les deux textes traitent de l'IA générative et de ses applications dans la création de contenu. Le premier adopte une vue d'ensemble large (marketing, éducation, recherche) tandis que le second se concentre sur les modèles de langage spécifiques.",
  "common_themes": [
    "intelligence artificielle générative",
    "génération de contenu",
    "recherche"
  ],
  "differences": [
    "Le texte 1 couvre aussi le visuel et l'audio, pas le texte 2",
    "Le texte 2 mentionne des modèles spécifiques (GPT, Llama)",
    "Le texte 1 inclut le marketing et l'éducation"
  ],
  "text1_unique": [
    "contenu visuel et audio",
    "marketing",
    "éducation"
  ],
  "text2_unique": [
    "GPT",
    "Llama",
    "rédaction automatique"
  ],
  "error": null,
  "response_time_ms": 1456
}

Intégration

Python

import requests

resp = requests.post(
    "https://api.s33d.fr/v1/compare",
    headers={"X-API-Key": "s33d_votre_clé_ici"},
    json={
        "text1": "Version A de notre page produit...",
        "text2": "Version B de notre page produit...",
        "lang": "fr"
    }
)

data = resp.json()
print(f"Similarité: {data['similarity_score']:.0%}")
print(f"Résumé: {data['summary']}")
print(f"Thèmes communs: {', '.join(data['common_themes'])}")
for diff in data['differences']:
    print(f"  - {diff}")

JavaScript

const resp = await fetch("https://api.s33d.fr/v1/compare", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "s33d_votre_clé_ici"
  },
  body: JSON.stringify({
    text1: "First version of the terms of service...",
    text2: "Updated version of the terms of service...",
    lang: "en"
  })
});

const { similarity_score, differences, common_themes } = await resp.json();
console.log(`Similarity: ${(similarity_score * 100).toFixed(0)}%`);
console.log(`Common themes: ${common_themes.join(", ")}`);
differences.forEach(d => console.log(`  △ ${d}`));