Recherche hybride
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.
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.
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 ».
Le prix, identique à une recherche simple
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. 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.
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 ?
Non. Le tarif est le même : $0.002 par appel et $0.0015 par requête. 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. Vous indexez une fois vos textes, puis choisissez la méthode d’interrogation requête par requête.
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.
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
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 '{"input":"…"}'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({
"input": "…"
})
});
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={
"input": "…"
},
)
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" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
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
{
"input": "…"
}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
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. |