Início rápido do Novita AI Search: sua primeira chamada de pesquisa na web

O AI Search dá à sua aplicação acesso em tempo real à web por meio de um único gateway da Novita. Em vez de se cadastrar em cada provedor de pesquisa, gerenciar chaves separadas e aprender diferentes esquemas de autenticação, você chama a Novita com uma chave de API e escolhe o mecanismo de pesquisa desejado em cada requisição. Este guia leva você do zero a uma pesquisa na web funcionando em poucos minutos. Você se autenticará com uma única chave de API da Novita, executará uma pesquisa e verá como trocar de provedor sem alterar sua configuração.

Antes de começar

Uma conta Novita e uma chave de API. Consulte Gerenciamento de chaves de API para criar uma.
Exporte sua chave para que os exemplos abaixo possam usá-la. NOVITA_API_KEY é apenas sua chave de API da Novita da etapa 1 — a mesma chave funciona para todos os provedores:

export NOVITA_API_KEY="<Your API Key>"

Todos os endpoints do AI Search compartilham a mesma URL base e autenticação:

URL base: https://api.novita.ai
Cabeçalho de autenticação: Authorization: Bearer <api_key>
Tipo de conteúdo: application/json

Sua primeira pesquisa

O exemplo abaixo executa uma pesquisa Exa. Cada requisição é apenas uma rota mais um corpo 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}`);
}

Alternando mecanismos de pesquisa

Alternar mecanismos de pesquisa significa alterar a rota e o corpo da requisição para corresponder ao provedor — sua chave, host e cabeçalho de autenticação permanecem os mesmos. Veja a mesma intenção expressa 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
  }'

Observe as pequenas diferenças: Exa usa numResults, Tavily usa max_results. A lista completa de parâmetros de cada provedor fica em sua referência de API.

Traga seu próprio SDK do provedor

O AI Search é uma integração pass-through, portanto o SDK oficial de um provedor funciona desde que permita substituir a URL base — aponte-o para a rota de gateway correspondente e passe sua chave Novita. O SDK Python da Exa, por exemplo, recebe um 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)

Se um SDK não expõe uma configuração de URL base, basta chamar os endpoints REST diretamente com qualquer cliente HTTP, como mostrado acima — esse caminho sempre funciona.

Como funciona

A Novita expõe cada provedor como um endpoint pass-through. Sua requisição é autenticada com sua chave de API da Novita e, em seguida, encaminhada ao provedor upstream usando o formato de requisição e resposta próprio do provedor.

Uma credencial. Use sua chave de API existente da Novita como Bearer <api_key> para todos os provedores.
Corpos nativos do provedor. Os formatos de requisição e resposta correspondem ao provedor upstream, então os exemplos e formatos de requisição do próprio provedor continuam válidos — basta apontar a URL base para a Novita.
Troque mecanismos por requisição. Alternar provedores significa alterar a rota e o corpo, não sua autenticação nem a configuração da sua conta.

Isso é útil sempre que um modelo precisa de informações nas quais não foi treinado: eventos atuais, documentação que muda rapidamente, preços ou qualquer fato que esteja na web aberta. Combine com a LLM API para criar geração aumentada por recuperação (RAG), agentes de pesquisa e assistentes fundamentados na web.

Provedores compatíveis

Exa

Pesquisa neural e semântica na web com extração de conteúdo e síntese de respostas integradas. Forte para pesquisa, encontrar páginas por significado e saída estruturada.

Tavily

Pesquisa e recuperação rápidas, otimizadas para LLM, com rastreamento e mapeamento de sites. Forte para tópicos de notícias e finanças, pipelines de extração e consultas de baixa latência.

Capacidades em resumo

Capacidade	O que faz	Exa	Tavily
Pesquisa	Encontra páginas relevantes a partir de uma consulta	Search	Search
Extração de conteúdo	Extrai texto limpo/metadata de URLs	Contents	Extract
Síntese de respostas	Gera uma resposta com citações a partir dos resultados	Answer	via `include_answer`
Rastreamento de site	Segue links para reunir muitas páginas	—	Crawl
Mapeamento de site	Descobre as URLs acessíveis de um site	—	Map

Referência de endpoints

Provedor	Endpoint	Rota
Exa	Search	`POST /v3/exa/search`
Exa	Contents	`POST /v3/exa/contents`
Exa	Answer	`POST /v3/exa/answer`
Tavily	Search	`POST /v3/tavily/search`
Tavily	Extract	`POST /v3/tavily/extract`
Tavily	Crawl	`POST /v3/tavily/crawl`
Tavily	Map	`POST /v3/tavily/map`

Solução de problemas

400 Bad Request — um parâmetro não corresponde ao esquema do provedor. Verifique se você está usando os nomes de campos desse provedor (por exemplo, numResults vs max_results).
429 Too Many Requests — você atingiu um limite de taxa. Aguarde e tente novamente, ou reduza o volume de requisições.

Para ver a lista completa, consulte a seção Erros em qualquer página de referência de API do AI Search.

Para onde ir agora

Respostas fundamentadas na web e RAG

Envie resultados de pesquisa para a LLM API para criar pipelines de geração aumentada por recuperação (RAG) com respostas citadas.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Início rápido

Antes de começar

Sua primeira pesquisa

Alternando mecanismos de pesquisa

Traga seu próprio SDK do provedor

Como funciona

Provedores compatíveis

Exa

Tavily

Capacidades em resumo

Referência de endpoints

Solução de problemas

Para onde ir agora

Respostas fundamentadas na web e RAG

​Antes de começar

​Sua primeira pesquisa

​Alternando mecanismos de pesquisa

​Traga seu próprio SDK do provedor

​Como funciona

​Provedores compatíveis

Exa

Tavily

​Capacidades em resumo

​Referência de endpoints

​Solução de problemas

​Para onde ir agora

Respostas fundamentadas na web e RAG

Antes de começar

Sua primeira pesquisa

Alternando mecanismos de pesquisa

Traga seu próprio SDK do provedor

Como funciona

Provedores compatíveis

Capacidades em resumo

Referência de endpoints

Solução de problemas

Para onde ir agora