Primeros pasos
¿Qué es AI Search?
AI Search es una única pasarela de Novita que proporciona a tu aplicación acceso en vivo para buscar en la web. Llamas a Novita con una clave de API y eliges un proveedor de búsqueda por solicitud, en lugar de registrarte con cada proveedor por separado. Consulta el Inicio rápido para obtener una visión completa.¿Qué proveedores son compatibles?
Actualmente Exa y Tavily. Cada uno se expone como un endpoint de passthrough que refleja el formato de solicitud y respuesta propio del proveedor. Consulta el Inicio rápido para la lista de endpoints.¿Necesito una cuenta separada de Exa o Tavily?
No. Tu clave de API de Novita autentica cada solicitud de AI Search. No gestionas claves ni cuentas de proveedores upstream.Autenticación y configuración
¿Cómo me autentico?
Usa tu clave de API de Novita como token de portador:Authorization: Bearer <api_key>. La misma clave funciona con todos los proveedores. Para crear o administrar claves, consulta Administración de claves de API.
¿Hay un SDK de Novita para AI Search?
No — y no necesitas uno. AI Search es una integración, no un producto empaquetado: cada endpoint es un passthrough que reenvía tu solicitud al proveedor (Exa o Tavily) en el formato nativo de ese proveedor. Eso significa que tienes dos buenas opciones:- Usa el SDK propio del proveedor. Si el SDK te permite establecer una URL base personalizada, apúntala a la ruta de gateway correspondiente y pasa tu clave de Novita. Por ejemplo, el SDK de Python de Exa acepta
base_url="https://api.novita.ai/v3/exa". Consulta la Guía de inicio rápido para ver un ejemplo completo. - Llama a los endpoints REST directamente. Funciona con cualquier cliente HTTP y no necesita ningún SDK. La Guía de inicio rápido muestra ejemplos en curl, Python y JavaScript.
¿Puedo cambiar de proveedores sin cambiar la estructura de mi código?
En su mayoría. La autenticación, el host y el flujo de la solicitud permanecen idénticos — cambias la ruta (p. ej./v3/tavily/search → /v3/exa/search) y alinear el cuerpo con los nombres de campo de ese proveedor (por ejemplo, los de Tavily max_results frente a Exa numResults).
Comportamiento de búsqueda
¿Qué tan recientes son los resultados?
Los resultados reflejan contenido web en vivo. Para preguntas sensibles al tiempo, limita por fecha para excluir páginas obsoletas: Tavily exponetime_range y start_date/end_date; Exa expone startPublishedDate/endPublishedDate.
¿Cómo restrinjo los resultados a sitios de confianza?
Usa filtros de dominio —include_domains/exclude_domains en Tavily, includeDomains/excludeDomains en Exa — para mantener la recuperación dentro de fuentes en las que confías.
¿Cuál es la diferencia entre search, extract y crawl?
- Search descubre páginas relevantes a partir de una consulta.
- Extract / Contents extrae texto limpio de URLs que ya tienes.
- Crawl / Map sigue enlaces para recopilar o listar muchas páginas de un sitio.
¿Puede AI Search generar una respuesta, no solo enlaces?
Sí. Tavily Search devuelve una respuesta de LLM cuando configurasinclude_answer, y Exa ofrece una Answer punto de conexión. Para tener control total sobre la redacción y las citas, recupera los resultados y sintetízalos con la API de LLM en su lugar — consulta Respuestas fundamentadas en la web.
Límites & solución de problemas
¿Cuáles son los límites de tasa?
Las solicitudes de AI Search están sujetas tanto a los límites de la plataforma Novita como a los límites propios de cada proveedor upstream, que dependen del nivel del proveedor vinculado a tu cuenta. Cuando superas un límite, la API devuelve429 Too Many Requests — espera y reintenta con un retraso exponencial. Estos límites son independientes de la LLM API de límites de tasa; una llamada de búsqueda no consume tu cuota de LLM.
¿Por qué recibo un error 400?
Es probable que un parámetro no coincida con el esquema del proveedor. Confirma que estás usando los nombres de campos de ese proveedor — una causa común es enviar los de Tavilymax_results a una ruta de Exa (que espera numResults).