A DeepSeek abriu duas ferramentas de acesso à web para desenvolvedores, oferecendo a agentes de IA e aplicações de geração aumentada por recuperação uma forma direta de extrair conteúdo ao vivo da internet. As ferramentas, uma Search API e uma Fetch API, estão listadas na documentação para desenvolvedores da empresa com preço de US$ 0,75 por 1.000 requisições bem-sucedidas para cada uma.

A Search API localiza páginas da web para uma consulta e retorna resultados estruturados. A DeepSeek afirma que o serviço funciona com seu próprio mecanismo de busca interno. A Fetch API funciona de outra maneira. Ela recebe um único endereço da web e retorna o conteúdo da página em Markdown, a linguagem de formatação de texto simples comum em ferramentas para desenvolvedores e pipelines de IA.

Ambas são interfaces JSON puras, e não bibliotecas de software. Os desenvolvedores enviam requisições para dois endpoints sob o endereço base https://api.deepseek.com, um em /v1/tools/search e outro em /v1/tools/fetch. A autenticação usa o mesmo token bearer exigido pela API de modelos da DeepSeek, enviado em um cabeçalho Authorization junto com um tipo de conteúdo JSON. A documentação inclui exemplos de código em curl e Python.

A Search API aceita uma consulta de 1 a 128 caracteres Unicode. Os desenvolvedores podem definir o número de resultados entre 1 e 50, com padrão de 10. Um parâmetro chamado need_content controla se a resposta inclui o texto completo das páginas. Seu padrão é false, o que significa que o campo de conteúdo volta vazio, a menos que o desenvolvedor solicite. Outros campos opcionais permitem repassar a pergunta original do usuário para ajudar o sistema a entender a consulta, ou fornecer um endereço IP para localizar os resultados.

A sintaxe de busca oferece suporte a operadores comuns. Os desenvolvedores podem restringir os resultados a sites específicos, excluir domínios ou termos, buscar frases exatas, filtrar por código de idioma e limitar os resultados a páginas publicadas antes ou depois de uma determinada data. Os operadores podem ser combinados em uma única consulta.

Cada resultado de busca inclui um título, uma URL, um trecho curto destinado à exibição e um resumo mais longo, pensado para ser lido por um modelo de linguagem. Os resultados também trazem uma pontuação de relevância de 0 a 3. A documentação considera pontuações iguais ou superiores a 1,5 como correspondências de alta qualidade. Cada resultado também inclui uma classificação de autoridade de 0 a 4, sendo que valores 3 ou superiores indicam fontes altamente autoritativas, além do nome do site, do ícone do site e da data de publicação, quando disponíveis. O valor -1 significa que o nível de autoridade é desconhecido.

A Fetch API aceita qualquer endereço HTTP ou HTTPS com até 8.192 caracteres. A URL não pode conter nome de usuário ou senha. A resposta inclui o título da página, que fica vazio se não estiver disponível, e o conteúdo da página em Markdown. A documentação alerta que a obtenção do conteúdo depende da disponibilidade e das políticas de acesso do site de destino. As páginas podem não carregar se estiverem indisponíveis, bloqueadas por política do site, entregues em um tipo de conteúdo não suportado ou se não contiverem texto extraível.

A cobrança está vinculada aos resultados bem-sucedidos, e não aos tokens ou à quantidade de itens retornados. Uma requisição só é cobrada quando retorna HTTP 200 e produz um resultado. Uma busca precisa retornar uma lista de resultados não vazia, e uma leitura precisa retornar o conteúdo da página. Requisições com falha, buscas sem resultados e timeouts não são cobrados. A documentação informa que a configuração de quantidade não altera o preço por requisição.

Há um período gratuito para alguns usuários. Desenvolvedores que acessam as ferramentas Search e Fetch pelo DeepSeek Harness, Claude Code ou Codex não pagam por essas chamadas de ferramentas no servidor por enquanto. A cobrança por requisição para essas chamadas começa às 00:00, no horário de Pequim, em 1º de novembro de 2026.

O uso é limitado por limites de taxa. Cada conta pode fazer 5 requisições por segundo para a Search e 5 para a Fetch. Os dois limites são contabilizados separadamente, de modo que o uso intenso de uma não consome a cota da outra. Os limites se aplicam à conta, independentemente de qual chave de API seja usada, e são separados dos limites de concorrência dos modelos. A Fetch também tem um limite por domínio. Requisições que excedam qualquer um dos limites recebem um erro HTTP 429.

A documentação lista uma série de códigos de erro. O 401 indica que a chave de API está ausente ou é inválida. O 402 indica que a conta tem saldo insuficiente e precisa ser recarregada antes de nova tentativa. Os códigos 408, 429 e 5xx pedem espera e nova tentativa, enquanto outros erros 4xx exigem alteração da requisição antes de tentar novamente.

Dieser Artikel wurde mit Unterstützung von KI verfasst.
News Factory APP - agentische News für besseres SEO & AEO.