Primeiros passos
O que é AI Search?
AI Search é um gateway único da Novita que dá ao seu aplicativo acesso em tempo real para pesquisar na web. Você chama a Novita com uma chave de API e escolhe um provedor de pesquisa por solicitação, em vez de se cadastrar em cada provedor separadamente. Consulte o Início rápido para o panorama completo.Quais provedores são compatíveis?
Atualmente Exa e Tavily. Cada um é exposto como um endpoint passthrough que espelha o formato de solicitação e resposta do próprio provedor. Consulte o Quickstart para a lista de endpoints.Preciso de uma conta Exa ou Tavily separada?
Não. Sua chave de API da Novita autentica todas as solicitações do AI Search. Você não gerencia chaves ou contas de provedores upstream.Autenticação e Configuração
Como faço a autenticação?
Use sua chave de API da Novita como um bearer token:Authorization: Bearer <api_key>. A mesma chave funciona para todos os provedores. Para criar ou gerenciar chaves, consulte Gerenciamento de chaves de API.
Existe um SDK da Novita para o AI Search?
Não — e você não precisa de um. O AI Search é uma integração, não um produto encapsulado: cada endpoint é um passthrough que encaminha sua solicitação ao provedor (Exa ou Tavily) no formato nativo desse provedor. Isso significa que você tem duas boas opções:- Use o SDK do próprio provedor. Se o SDK permitir definir uma URL base personalizada, aponte-o para a rota de gateway correspondente e passe sua chave da Novita. Por exemplo, o SDK Python da Exa aceita
base_url="https://api.novita.ai/v3/exa". Consulte o Guia de início rápido para um exemplo completo. - Chame os endpoints REST diretamente. Funciona com qualquer cliente HTTP e não requer nenhum SDK. O Guia de início rápido mostra exemplos em curl, Python, e JavaScript.
Posso trocar de provedores sem alterar a estrutura do meu código?
Na maioria das vezes. A autenticação, o host, e o fluxo da requisição permanecem idênticos — você altera a rota (e.g./v3/tavily/search → /v3/exa/search) e alinhe o corpo aos nomes dos campos desse provedor (por exemplo, da Tavily max_results vs os da Exa numResults).
Comportamento da busca
Quão recentes são os resultados?
Os resultados refletem conteúdo da web em tempo real. Para perguntas sensíveis ao tempo, restrinja por data para manter páginas desatualizadas fora: Tavily expõetime_range e start_date/end_date; A Exa expõe startPublishedDate/endPublishedDate.
Como restringir os resultados a sites confiáveis?
Use filtros de domínio —include_domains/exclude_domains no Tavily, includeDomains/excludeDomains na Exa — para manter a recuperação dentro de fontes em que você confia.
Qual é a diferença entre search, extract e crawl?
- Search descobre páginas relevantes a partir de uma consulta.
- Extract / Contents extrai texto limpo de URLs que você já tem.
- Crawl / Map segue links para coletar ou listar muitas páginas de um site.
A AI Search pode gerar uma resposta, não apenas links?
Sim. Tavily Search retorna uma resposta de LLM quando você defineinclude_answer, e a Exa oferece um Answer endpoint. Para ter controle total sobre a redação e as citações, recupere os resultados e sintetize com a LLM API em vez disso — consulte Respostas fundamentadas na Web.
Limites e solução de problemas
Quais são os limites de taxa?
As solicitações do AI Search estão sujeitas tanto aos limites da plataforma Novita quanto aos limites próprios de cada provedor upstream, que dependem do nível do provedor vinculado à sua conta. Quando você excede um limite, a API retorna429 Too Many Requests — aguarde e tente novamente com atraso exponencial. Esses limites são independentes da API de LLM limites de taxa; uma chamada de busca não consome sua cota de LLM.
Por que estou recebendo um erro 400?
Um parâmetro provavelmente não corresponde ao schema do provedor. Confirme se você está usando os nomes de campo desse provedor — uma causa comum é enviar os do Tavilymax_results para uma rota Exa (que espera numResults).