ForHosting KIT · Recherche sémantique

Recherche hybride

Une seule barre de recherche qui comprend « SKU-88213 » comme « veste de course légère » : les termes exacts gardent leur précision, les descriptions floues sont comparées par le sens et les deux classements fusionnent en une liste. Paiement à l'usage, sans abonnement.

● Stablepar requête + par recherche$0.002

Lancer — $0.002 + $0.0015/recherche Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exécuter en ligne

Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.

La recherche hybride mêle deux façons de chercher : la correspondance de mots exacts et la proximité de sens. Elle comprend une question formulée librement tout en respectant les termes qui doivent tomber juste — une référence, un numéro de SIRET, un nom propre. Le tout en une seule requête.

Quand le sens seul ne suffit pas

La recherche par le sens excelle sur les idées, mais peut hésiter sur un code précis : une référence « GAR-4021 » ou un numéro de facture n’ont pas de synonyme, ils doivent correspondre à l’identique. La recherche par mot-clé, elle, est aveugle aux reformulations. L’approche hybride fait travailler les deux ensemble : elle exige les termes exacts là où ils comptent et interprète le reste par le sens.

Comment les deux scores se combinent

Chaque fragment reçoit deux notes : une pour la présence des mots exacts, une pour la proximité de sens. KIT les fusionne en un classement unique, de sorte qu’un passage à la fois pertinent sur le fond et porteur du bon numéro remonte en tête. Vous n’avez pas à choisir un camp : la requête « facture GAR-4021 impayée » trouve la bonne pièce même si le document parle de « règlement en attente ».

Cas d’usage

Suivi de factures

Un auto-entrepreneur cherche « relance facture F-2026-118 » dans ses documents indexés. Le numéro exact verrouille la bonne facture, tandis que le sens rattache aussi les e-mails de relance qui n’en citent que le montant.

Catalogue avec références

Atelier Garnier SARL vend des meubles à références codées. Un vendeur tape « console chêne réf GAR-77 » : la référence garantit le bon produit, la partie sémantique tolère l’approximation sur la description.

Base juridique

Un cabinet interroge ses contrats en citant à la fois un article précis, « art. 1231-5 », et une idée, « indemnité de retard ». L’hybride réunit la citation exacte et les clauses de sens voisin.

Questions fréquentes

Mots-clés ou sens : faut-il vraiment choisir ?

Non, c’est précisément l’intérêt de l’hybride. Il applique la correspondance exacte aux termes qui l’exigent — codes, références, noms — et la proximité de sens au reste, puis fusionne le tout en un seul classement.

Dans quels cas préférer l’hybride à la recherche sémantique seule ?

Dès que vos contenus contiennent des identifiants qui doivent tomber juste : numéros de facture, SKU, références d’articles, numéros de dossier. Le sens seul risquerait de les confondre avec des voisins ; l’hybride les verrouille.

Est-ce plus cher qu’une recherche classique ?

La précision supplémentaire est incluse, sans surcoût ni abonnement.

Faut-il un index particulier ?

Non, l’hybride s’exerce sur le même index que la recherche sémantique.

Mes requêtes sont-elles enregistrées ?

La requête sert à interroger votre index, puis n’est pas réutilisée pour vous profiler ni pour entraîner un modèle. Votre index reste privé et supprimable à votre demande.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/search/hybrid

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/search/hybrid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"SKU-88213 chaqueta impermeable"}'

const res = await fetch("https://api.kit.forhosting.com/search/hybrid", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "query": "SKU-88213 chaqueta impermeable"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/search/hybrid",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "query": "SKU-88213 chaqueta impermeable"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/hybrid", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"query":"SKU-88213 chaqueta impermeable"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"query":"SKU-88213 chaqueta impermeable"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/hybrid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "query": "SKU-88213 chaqueta impermeable"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.hybrid",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

par recherche$0.0015

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_chunks`	10000
`max_tokens`	20000

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Le prix, identique à une recherche simple

Comme toujours, aucun abonnement : vous payez les recherches lancées, le montant s’affiche avant d’exécuter, et l’euro ne figure que dans vos documents d’exemple. La recherche hybride se facture comme une recherche classique : $0.002 par appel et $0.0015 par requête, en dollars US. Le surcroît de précision ne coûte pas plus cher, et vous n’avez pas à choisir la méthode à l’avance : elle se décide requête par requête.

Consulter la documentation complète du KIT →