Búsqueda híbrida
La búsqueda por palabra clave pura no capta las paráfrasis; la búsqueda semántica pura a veces no prioriza un número de parte exacto o un código de producto que debería reconocer al instante. Este endpoint ejecuta ambas en la misma llamada y fusiona los dos rankings en un solo conjunto de resultados, así una consulta obtiene precisión en términos exactos y comprensión conceptual a la vez.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El compromiso que ninguno de los dos enfoques resuelve solo
La búsqueda por palabra clave es precisa con términos exactos —un SKU, un número de modelo, una cita legal— pero ciega ante la paráfrasis. La búsqueda semántica entiende la paráfrasis pero ocasionalmente ubica un concepto vagamente relacionado por encima de un documento que contiene el término literal que el usuario escribió, sobre todo si ese término es poco frecuente. Ninguna debilidad es fatal por sí sola, pero un cuadro de búsqueda que solo hace una de las dos cosas tendrá un desempeño inferior en una parte real de las consultas, y casi nunca sabe de antemano qué tipo de consulta le harán.
Qué hace realmente la fusión
Envía por POST una consulta y su conjunto de candidatos a /search/hybrid, y la tarea ejecuta en paralelo una coincidencia por palabras clave y otra por significado, y combina ambos rankings en un solo puntaje fusionado por documento, en lugar de obligarle a elegir un ganador o hacer dos llamadas separadas y fusionar los resultados por su cuenta. Un documento que puntúa bien en ambas señales sube al primer lugar; uno que solo puntúa bien en una igual aparece, solo más abajo, en vez de desaparecer como pasaría en un sistema de un solo método.
Una idea consolidada en la recuperación de información
Combinar señales léxicas y vectoriales no es nuevo; los ingenieros de búsqueda usan técnicas de fusión de rankings desde hace años para mezclar listas de resultados puntuadas por separado en un solo orden que supera a cualquiera de las dos. Lo que cambió es que el ranking por significado antes requería infraestructura especializada que pocos equipos podían justificar construir, mientras la búsqueda por palabra clave lleva décadas siendo un commodity; este endpoint empaqueta la fusión de ambas en una sola llamada para que no opere dos sistemas y una las salidas usted mismo.
Dónde la búsqueda híbrida supera a los dos métodos por separado
El comercio electrónico es el caso más claro: un comprador puede escribir un número de modelo exacto en un momento y 'zapatos impermeables para caminata' al siguiente, y ambos deben funcionar bien desde el mismo cuadro de búsqueda. La documentación, los tickets de soporte y la búsqueda empresarial sobre contenido mixto se benefician igual, porque las consultas reales mezclan términos exactos y descripciones sueltas y casi nunca anuncian de antemano cuál de las dos son.
Precio y entrega
La facturación es una tarifa plana por solicitud más un cargo por consulta, la misma estructura sin importar si la consulta se inclina hacia palabras clave o es totalmente conceptual, sin cargo aparte por ejecutar ambas señales. La llamada es asíncrona: recibe un task_id de inmediato y el resultado fusionado llega mediante webhook firmado o un enlace firmado válido por 24 horas; las tareas fallidas reintentan hasta tres veces y nunca se cobran si siguen sin completarse.
Qué puede hacer con ella
Cuadro de búsqueda de comercio electrónico
La búsqueda de una tienda responde bien tanto a 'SKU-88213' como a 'chaqueta ligera para correr', desde el mismo campo de entrada y sin lógica separada para cada estilo de consulta.
Búsqueda en documentación técnica
Un portal para desarrolladores encuentra nombres exactos de funciones y códigos de error, además de problemas descritos de forma libre como 'por qué mi solicitud da timeout'.
Deduplicación de tickets de soporte
Una mesa de ayuda encuentra tickets previos que mencionan el mismo código de producto o describen el mismo problema con otras palabras, reduciendo el trabajo de investigación duplicado.
Búsqueda empresarial sobre contenido mixto
Una herramienta de búsqueda corporativa ordena correctamente números de contrato, identificadores de póliza y preguntas en lenguaje natural dentro del mismo índice, sin mantener dos sistemas de búsqueda separados.
Preguntas frecuentes
¿Qué es la búsqueda híbrida y en qué se diferencia de la búsqueda semántica sola?
La búsqueda híbrida combina coincidencia por palabra clave con ranking basado en significado en un solo conjunto de resultados fusionado, capturando tanto términos exactos como consultas parafraseadas que la búsqueda semántica pura a veces puede ubicar más abajo de lo debido.
¿Necesito configurar el peso entre las señales de palabra clave y vectoriales?
No, envía la consulta y los candidatos al endpoint y este se encarga de la fusión; no hay infraestructura aparte ni paso de ajuste requerido de su lado.
¿La búsqueda híbrida es gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo recibo los resultados?
El endpoint devuelve un task_id de inmediato y los resultados fusionados y ordenados llegan mediante webhook firmado o un enlace firmado válido por 24 horas.
¿Cuándo debería usar búsqueda híbrida en vez de búsqueda semántica pura?
Úsela siempre que las consultas puedan incluir términos exactos como SKU, códigos o nombres junto con descripciones en lenguaje natural, que es el caso de la mayoría de los cuadros de búsqueda reales.
¿La búsqueda híbrida soporta catálogos de productos o conjuntos de documentos grandes?
Sí, envía cada consulta como su propia solicitud asíncrona contra su conjunto de candidatos sin límite artificial en el volumen de solicitudes, facturado a la tarifa estándar por solicitud y por consulta.
¿La búsqueda híbrida cuesta más que la búsqueda semántica sola?
No, el precio es la misma tarifa base más el cargo por consulta; ejecutar ambas señales en una sola llamada está incluido, no se factura como dos operaciones separadas.
¿Qué pasa si falla una solicitud de búsqueda híbrida?
La tarea reintenta automáticamente hasta tres veces, devuelve un error claro si sigue sin completarse, y una solicitud fallida nunca se cobra.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su 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)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.hybrid",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_chunks | 10000 |
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |