Entities API

POST /v1/entities

Extrait les entités nommées d'un texte avec leur type et un score de confiance.

Paramètres

Exemple

Requête

{
  "text": "En janvier 2026, OpenAI a annoncé un partenariat avec Microsoft à Seattle pour un investissement de 10 milliards de dollars dans l'IA générative.",
  "types": ["ORGANIZATION", "LOCATION", "MONEY", "DATE"]
}

Réponse

{
  "entities": [
    {"text": "janvier 2026", "type": "DATE", "confidence": 0.95},
    {"text": "OpenAI", "type": "ORGANIZATION", "confidence": 0.98},
    {"text": "Microsoft", "type": "ORGANIZATION", "confidence": 0.99},
    {"text": "Seattle", "type": "LOCATION", "confidence": 0.97},
    {"text": "10 milliards de dollars", "type": "MONEY", "confidence": 0.93}
  ],
  "total": 5,
  "error": null,
  "response_time_ms": 1205
}

Intégration

Python

import requests

resp = requests.post(
    "https://api.s33d.fr/v1/entities",
    headers={"X-API-Key": "s33d_votre_clé_ici"},
    json={
        "text": "Elon Musk a lancé Neuralink en 2026 depuis San Francisco.",
        "types": ["PERSON", "ORGANIZATION", "LOCATION"]
    }
)

for entity in resp.json()["entities"]:
    print(f"[{entity['type']}] {entity['text']} (confiance: {entity['confidence']:.0%})")

JavaScript

const resp = await fetch("https://api.s33d.fr/v1/entities", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "s33d_votre_clé_ici"
  },
  body: JSON.stringify({
    text: "Apple announced a new iPhone model at their Cupertino headquarters."
  })
});

const { entities, total } = await resp.json();
console.log(`Found ${total} entities:`);
entities.forEach(e => console.log(`  [${e.type}] ${e.text}`));