> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Preguntas frecuentes sobre AI Search

## 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](/docs/es/guides/ai-search-quickstart) 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](/docs/es/guides/ai-search-quickstart) 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](/docs/es/api-reference/basic-authentication).

### ¿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](/docs/es/guides/ai-search-quickstart#bring-your-own-provider-sdk) 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](/docs/es/guides/ai-search-quickstart) muestra ejemplos en curl, Python y JavaScript.

Si un SDK no expone una configuración de base-URL, usa la ruta REST en su lugar.

## ¿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 expone `time_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.

Consulta [Web-Grounded Answers](/docs/es/guides/ai-search-grounded-answers#search-vs-extract-vs-crawl) para obtener orientación sobre cuál usar.

### ¿Puede AI Search generar una respuesta, no solo enlaces?

Sí. Tavily Search devuelve una respuesta de LLM cuando configuras `include_answer`, y Exa ofrece una [Answer](/docs/es/api-reference/model-apis-exa-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](/docs/es/guides/llm-api) en su lugar — consulta [Respuestas fundamentadas en la web](/docs/es/guides/ai-search-grounded-answers).

## 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 devuelve `429 Too Many Requests` — espera y reintenta con un retraso exponencial. Estos límites son independientes de la [LLM API](/docs/es/guides/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 Tavily `max_results` a una ruta de Exa (que espera `numResults`).

### ¿Dónde puedo obtener más ayuda?

Para preguntas sobre integración o límites más altos, [agenda una llamada con nuestro equipo](https://meet.brevo.com/novita-ai/contact-sales).
