Inicio rápido de Novita AI Search: tu primera llamada de búsqueda web

AI Search le da a tu aplicación acceso en vivo a la web a través de una única pasarela de Novita. En lugar de registrarte con cada proveedor de búsqueda, gestionar claves separadas y aprender distintos esquemas de autenticación, llamas a Novita con una sola clave de API y eliges el motor de búsqueda que quieras en cada solicitud. Esta guía te lleva desde cero hasta una búsqueda web funcional en unos minutos. Te autenticarás con una sola clave de API de Novita, ejecutarás una búsqueda y verás cómo cambiar de proveedor sin modificar tu configuración.

Antes de empezar

Una cuenta de Novita y una clave de API. Consulta Gestión de claves de API para crear una.
Exporta tu clave para que los ejemplos siguientes puedan usarla. NOVITA_API_KEY es simplemente tu clave de API de Novita del paso 1; la misma clave funciona para todos los proveedores:

export NOVITA_API_KEY="<Your API Key>"

Todos los endpoints de AI Search comparten la misma URL base y autenticación:

URL base: https://api.novita.ai
Encabezado de autenticación: Authorization: Bearer <api_key>
Tipo de contenido: application/json

Tu primera búsqueda

El siguiente ejemplo ejecuta una búsqueda de Exa. Cada solicitud es simplemente una ruta más un cuerpo JSON.

curl -X POST 'https://api.novita.ai/v3/exa/search' \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest open-source LLM releases",
    "numResults": 5
  }'

import os
import requests

resp = requests.post(
    "https://api.novita.ai/v3/exa/search",
    headers={
        "Authorization": f"Bearer {os.environ['NOVITA_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "query": "latest open-source LLM releases",
        "numResults": 5,
    },
)
resp.raise_for_status()

for result in resp.json()["results"]:
    print(result["title"], "-", result["url"])

const resp = await fetch("https://api.novita.ai/v3/exa/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NOVITA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "latest open-source LLM releases",
    numResults: 5,
  }),
});

const data = await resp.json();
for (const result of data.results) {
  console.log(`${result.title} - ${result.url}`);
}

Cambiar de motor de búsqueda

Cambiar de motor de búsqueda significa cambiar la ruta y el cuerpo de la solicitud para que coincidan con el proveedor; tu clave, host y encabezado de autenticación siguen siendo los mismos. Aquí está la misma intención expresada para Tavily:

curl -X POST 'https://api.novita.ai/v3/tavily/search' \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest open-source LLM releases",
    "max_results": 5
  }'

Observa las pequeñas diferencias: Exa usa numResults, Tavily usa max_results. La lista completa de parámetros de cada proveedor está en su referencia de API.

Trae tu propio SDK del proveedor

AI Search es una integración passthrough, por lo que el SDK oficial de un proveedor funciona siempre que te permita sobrescribir la URL base: apúntalo a la ruta de pasarela correspondiente y pasa tu clave de Novita. El SDK de Python de Exa, por ejemplo, acepta un base_url:

import os
from exa_py import Exa

exa = Exa(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/exa",
)

results = exa.search("latest open-source LLM releases", num_results=5)
for r in results.results:
    print(r.title, "-", r.url)

Si un SDK no expone una configuración de URL base, simplemente llama a los endpoints REST directamente con cualquier cliente HTTP, como se muestra arriba; ese camino siempre funciona.

Cómo funciona

Novita expone cada proveedor como un endpoint passthrough. Tu solicitud se autentica con tu clave de API de Novita y luego se reenvía al proveedor upstream usando el formato de solicitud y respuesta propio del proveedor.

Una credencial. Usa tu clave de API de Novita existente como Bearer <api_key> para todos los proveedores.
Cuerpos nativos del proveedor. Las formas de solicitud y respuesta coinciden con el proveedor upstream, por lo que los ejemplos y formatos de solicitud propios del proveedor se mantienen; simplemente apunta la URL base a Novita.
Cambia de motor por solicitud. Cambiar de proveedor significa cambiar la ruta y el cuerpo, no tu autenticación ni la configuración de tu cuenta.

Esto es útil siempre que un modelo necesite información con la que no fue entrenado: eventos actuales, documentación que cambia rápidamente, precios o cualquier dato que esté en la web abierta. Combínalo con la LLM API para crear generación aumentada por recuperación (RAG), agentes de investigación y asistentes fundamentados en la web.

Proveedores compatibles

Exa

Búsqueda web neuronal y semántica con extracción de contenido y síntesis de respuestas integradas. Potente para investigación, encontrar páginas por significado y generar salida estructurada.

Tavily

Búsqueda y recuperación rápidas, optimizadas para LLM, con rastreo y mapeo de sitios. Potente para temas de noticias y finanzas, pipelines de extracción y consultas de baja latencia.

Capacidades de un vistazo

Capacidad	Qué hace	Exa	Tavily
Búsqueda	Encuentra páginas relevantes a partir de una consulta	Búsqueda	Búsqueda
Extracción de contenido	Extrae texto limpio/metadata desde URLs	Contenido	Extracción
Síntesis de respuestas	Genera una respuesta citada a partir de resultados	Respuesta	mediante `include_answer`
Rastreo de sitios	Sigue enlaces para recopilar muchas páginas	—	Rastreo
Mapeo de sitios	Descubre las URLs accesibles de un sitio	—	Mapa

Referencia de endpoints

Proveedor	Endpoint	Ruta
Exa	Búsqueda	`POST /v3/exa/search`
Exa	Contenido	`POST /v3/exa/contents`
Exa	Respuesta	`POST /v3/exa/answer`
Tavily	Búsqueda	`POST /v3/tavily/search`
Tavily	Extracción	`POST /v3/tavily/extract`
Tavily	Rastreo	`POST /v3/tavily/crawl`
Tavily	Mapa	`POST /v3/tavily/map`

Solución de problemas

400 Bad Request — un parámetro no coincide con el esquema del proveedor. Comprueba que estés usando los nombres de campo de ese proveedor (por ejemplo, numResults frente a max_results).
429 Too Many Requests — has alcanzado un límite de frecuencia. Espera y vuelve a intentarlo, o reduce el volumen de solicitudes.

Para ver la lista completa, consulta la sección de errores en cualquier página de referencia de API de AI Search.

Adónde ir después

Respuestas fundamentadas en la web y RAG

Envía los resultados de búsqueda a la LLM API para crear pipelines de generación aumentada por recuperación (RAG) con respuestas citadas.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Inicio rápido

Antes de empezar

Tu primera búsqueda

Cambiar de motor de búsqueda

Trae tu propio SDK del proveedor

Cómo funciona

Proveedores compatibles

Exa

Tavily

Capacidades de un vistazo

Referencia de endpoints

Solución de problemas

Adónde ir después

Respuestas fundamentadas en la web y RAG

​Antes de empezar

​Tu primera búsqueda

​Cambiar de motor de búsqueda

​Trae tu propio SDK del proveedor

​Cómo funciona

​Proveedores compatibles

Exa

Tavily

​Capacidades de un vistazo

​Referencia de endpoints

​Solución de problemas

​Adónde ir después

Respuestas fundamentadas en la web y RAG

Antes de empezar

Tu primera búsqueda

Cambiar de motor de búsqueda

Trae tu propio SDK del proveedor

Cómo funciona

Proveedores compatibles

Capacidades de un vistazo

Referencia de endpoints

Solución de problemas

Adónde ir después