|

Como é calculada a taxa de conexão à internet do deepseek-flash? A query é a unidade de contagem.

Como é calculada a taxa de conexão à internet do deepseek-flash? A query é a unidade de contagem.

Nota do autor: o deepseek-flash já vem com busca na web integrada, mas o botão de raciocínio muda a forma como a busca acontece, a cobrança é feita por query e, na rodada seguinte, sobra apenas o texto da resposta. Este artigo explica os três pontos em que ele se diferencia de uma chamada de ferramenta comum — e também quando você não deve deixar o modelo buscar sozinho.

Em 2026-11-13, a DeepSeek anunciou oficialmente a abertura da capacidade de conversa do App para a API. Desta vez, só o deepseek-flash vem com esse conjunto de recursos, na versão DeepSeek-V4.1-Flash-1017. Basta declarar um deepseek_web_search e o deepseek-flash consegue navegar sozinho: a chamada da ferramenta e a montagem do contexto acontecem no servidor.

Muita gente vai entender isso como “ligar um interruptor e o resto é igual a uma chamada de função normal”. Não é um interruptor simples. Com o raciocínio ligado ou desligado, a forma de buscar muda; o número de vezes mostrado no retorno não é o número que você paga; e, quando chega a próxima rodada, tudo o que o modelo buscou, leu e pensou já não está no contexto.

O que você leva daqui: ao terminar o artigo, você vai saber onde o deepseek-flash se diferencia de uma chamada de ferramenta comum nos três pontos — raciocínio, cobrança e rodada seguinte — e vai conseguir decidir quando deixar o modelo buscar por conta própria e quando é o seu código que deve fazer a busca.

deepseek-flash-search-thinking-billing-next-turn-pt-pt-image-0


deepseek-flash busca, mas também esquece: três pontos centrais

Vamos direto à conclusão. A tabela abaixo lista três diferenças entre a busca integrada do deepseek-flash e o fluxo que você conhece — “o modelo dispara a chamada, o programa executa, o resultado volta”.

Ponto Comportamento real do deepseek-flash Diferença em relação à chamada de função comum
Pensamento Com o pensamento desativado, é uma busca na web ou de imagens com citações; com o pensamento ativado, vira uma busca com raciocínio profundo A mesma declaração de ferramenta vira dois fluxos dependendo do interruptor de pensamento
Cobrança A busca integrada conta pelo número de queries; uma busca com três queries conta como três Não é “uma chamada conta como uma”; a contagem em usage também não é igual ao número de cobranças
Próxima rodada Resultados da busca, páginas abertas e pensamento não entram na próxima rodada; só o texto da resposta é mantido O resultado de uma chamada de função comum normalmente é gravado por você no histórico e pode ser mantido

A origem das três diferenças do deepseek-flash

As três diferenças vêm do mesmo design: a chamada da ferramenta acontece no servidor. Você não vê as mensagens intermediárias de tool call, nem tem a chance de decidir quais conteúdos voltam para o histórico. O servidor busca, lê e monta o contexto por você; quando a resposta termina, o processo intermediário também é descartado.

Integrar assim é muito prático, mas o preço é ter menos controle. Quais queries são enviadas, quais páginas foram abertas e se a próxima rodada ainda pode citar o texto original da rodada anterior — tudo isso fica a cargo do servidor. Entendendo isso, o conteúdo das três seções seguintes passa a fazer sentido.


Como o interruptor de raciocínio do deepseek-flash altera a busca

A documentação oficial Build a Chatbot deixa a comparação bem clara: ao declarar o mesmo deepseek_web_search, se o interruptor de raciocínio estiver diferente, o comportamento muda.

deepseek-flash-search-thinking-billing-next-turn-pt-pt-image-1

Interruptor de raciocínio Ferramentas declaradas Comportamento real O link será lido separadamente?
Desligado deepseek_web_search Busca páginas da web ou imagens conforme a pergunta, e a resposta traz citações Não se aplica
Desligado deepseek_web_search + deepseek_read_url Busca com citações; links na mensagem do usuário são buscados à parte Sim
Ligado deepseek_web_search Busca com raciocínio profundo: durante o raciocínio em várias etapas, ele mesmo busca e ele mesmo abre páginas O modelo decide quais páginas abrir
Ligado deepseek_web_search + deepseek_read_url Continua sendo busca com raciocínio profundo Não lê o link separadamente
Qualquer Apenas deepseek_read_url Identifica e busca links na mensagem do usuário Sim

As duas armadilhas da busca com raciocínio profundo do deepseek-flash

A primeira armadilha é a leitura de links. O usuário colou um link, e você pensa que, por ter declarado deepseek_read_url, a página será necessariamente lida. Mas, desde que o raciocínio esteja ligado e deepseek_web_search também esteja declarado, nesta rodada ocorre a busca com raciocínio profundo, e o link deixa de ser lido separadamente; se essa página deve ser aberta ou não, o modelo decide durante o raciocínio. Se o seu produto promete “colou o link, leu o texto original”, ou você desliga o raciocínio, ou nesta rodada declara apenas deepseek_read_url.

A segunda armadilha são os parâmetros. Depois de ativar deepseek_web_search, ativar deepseek_read_url, definir safety_check como high ou ativar o title, o servidor ignora uma série de parâmetros de amostragem, como temperature e top_p; as listas de parâmetros ignorados nos três protocolos não são completamente iguais. max_tokens (no protocolo Responses, max_output_tokens) ainda tem efeito, mas limita a saída de cada etapa de raciocínio dentro de uma rodada, não o total da rodada. Portanto, na busca com raciocínio profundo, usar max_tokens para estimar o limite de custo de uma rodada não é preciso.

Como é calculada a cobrança do acesso à internet do deepseek-flash

A cobrança é a parte mais fácil de errar, porque aqui existem duas unidades de contagem diferentes. Vou explicar cada uma separadamente.

deepseek-flash-search-thinking-billing-next-turn-pt-pt-image-2

Cenário Unidade de contagem Como conta como uma vez Casos sem cobrança
Busca na web integrada query Uma busca que retorna resultados conta conforme o número de queries que ela contém Falha, sem resultados
Busca de imagens integrada imagem + região Cada imagem conta 1 vez, e cada região que o modelo delimita na imagem soma mais 1 Falha, sem resultados
Leitura de links integrada página capturada com sucesso A cobrança acontece assim que a captura é feita, incluindo páginas que depois forem substituídas por url_not_allowed ou unavailable por revisão de segurança Links que não puderam ser capturados
Acessos repetidos na busca do raciocínio profundo captura real Só a captura efetivamente feita na web é cobrada Reabrir a mesma página, navegar dentro da página, conteúdo já trazido junto com os resultados da busca
Interface Search / Fetch independente requisição bem-sucedida Só conta uma vez com HTTP 200 e resultados; count não altera o preço dessa requisição Falha, resultado vazio, timeout

Na página oficial de preços (2026-11-15), Search (texto e imagem) e Web fetch custam 0,75 dólar por 1000 chamadas. O preço unitário é o mesmo, mas a “vez” das ferramentas integradas se refere a uma query, enquanto a “vez” da interface independente se refere a uma requisição bem-sucedida — os números dos dois não podem ser comparados diretamente.

Não confunda os campos de usage do deepseek-flash

Nos usage retornados existem dois grupos de campos que parecem muito parecidos, mas têm significados diferentes:

Campo Significado Serve para conciliação?
web_search_requests Quantidade de blocos de resultados de busca para exibição, incluindo erros Não
web_fetch_requests Quantidade de blocos de resultados de captura para exibição, incluindo erros Não
tool_search Número de buscas cobradas Sim
tool_fetch Número de capturas cobradas Sim
tool_image_search Número de buscas de imagem cobradas Sim

Se você usar web_search_requests para fazer estatísticas de uso, os números podem ficar inflados, porque incluem blocos de resultados com falha; ao mesmo tempo, ele não mostra quantas queries existem em uma busca. Para conciliação, use os três campos tool_*.

O custo das ferramentas é cobrado separadamente do custo de token. O preço de token do deepseek-flash no site oficial divide-se entre horário de pico e horário ocioso: o pico é de segunda a sexta, das 01:00–04:00 e das 06:00–10:00 UTC (exceto feriados nacionais chineses), e todo o restante do tempo é horário ocioso, com preço equivalente à metade do pico.


Por que o deepseek-flash “esquece” no turno seguinte

A documentação oficial explica que, em conversas com vários turnos, os resultados de busca, as páginas abertas e o raciocínio do turno anterior não entram no contexto do turno seguinte; só o texto da resposta é mantido.

Então o “esquece” do título quer dizer que o contexto foi apagado, e não que o modelo não tenha encontrado nada na busca. No turno anterior, ele pode ter lido cinco páginas e citado três trechos do texto original; no turno seguinte, tem em mãos apenas o trecho de resposta que ele mesmo escreveu. Quando o usuário pergunta “o que diz o texto original da segunda fonte?”, o modelo ou faz uma nova busca (gerando mais uma cobrança pelo uso da ferramenta), ou só consegue fazer suposições com base na própria resposta.

deepseek-flash-search-thinking-billing-next-turn-pt-pt-image-3

Quando não vale a pena deixar o deepseek-flash buscar sozinho

Nestes casos, é melhor que o programa decida o que buscar, em vez de deixar isso a cargo do modelo:

  • É preciso citar o texto original entre turnos: por exemplo, cláusulas de regulamentos, contratos e perguntas e respostas sobre documentos longos, em que o próximo turno ainda precisa responder com base no texto original.
  • É preciso ter uma cobrança previsível: a busca com raciocínio profundo dispara várias queries e abre várias páginas, e não há como controlar isso de antemão.
  • É preciso restringir as fontes de informação: permitir apenas determinados sites ou excluir obrigatoriamente alguns sites.
  • Ao colar um link, é obrigatório ler o texto original: com o raciocínio ativado, o link pode não ser lido separadamente.
  • A chave API não está no site oficial da DeepSeek: a plataforma usada pode não ter as ferramentas integradas; a próxima seção explica os detalhes.

Primeiros passos com o deepseek-flash: como manter uma página web no contexto

Para manter uma página web no contexto, a ideia é separar “busca” e “resposta”: o programa chama as APIs de busca e captura, monta o conteúdo principal dentro de messages por conta própria e depois entrega tudo ao deepseek-flash para responder. Assim, o texto original da página fica no histórico que você mesmo salva e não se perde na próxima rodada.

No APIYI (apiyi.com), já existem dois endpoints independentes disponíveis: deepseek-search e deepseek-fetch, lançados em 2026-10-21. Eles não são modelos de conversa, não consomem tokens e são cobrados por requisição bem-sucedida; as regras de cobrança são as mesmas dos endpoints independentes do site oficial. Veja os passos:

  1. No console do APIYI, crie um token de API e escolha o grupo default ou svip. Se usar o grupo ClaudeCode, a API retorna 503, com a mensagem de erro literal no available channels for model deepseek-search.
  2. Busca: faça POST para /v1/tools/search, com a URL base https://api.apiyi.com; o corpo da requisição não precisa do campo model.
  3. query é obrigatório, tem de 1 a 128 caracteres e aceita site:, -site:, aspas, lang:, after: e before:
  4. count aceita valores de 1 a 50, o padrão é 10 e isso não afeta o preço
  5. need_content vem como false por padrão; quando definido como true, também retorna o conteúdo principal
  6. localization deve receber o IP do usuário; se você colocar um código de idioma como zh-CN, a API retorna 400
  7. Fetch: escolha o link que deseja ler e faça POST para /v1/tools/fetch; url precisa ser um endereço http ou https com domínio, ter no máximo 8192 caracteres e não pode incluir nome de usuário e senha.
  8. Resposta: coloque o conteúdo principal extraído como uma mensagem em messages, chame deepseek-flash e defina o base_url compatível com OpenAI como https://api.apiyi.com/v1.
  9. Retenção: grave esse conteúdo da página no seu próprio histórico de conversa e continue incluindo-o na próxima rodada, ou mantenha apenas um resumo para controlar o uso de tokens.

Os limites de taxa do upstream, conforme a documentação, são: Search com 100 QPS, Fetch com 25 QPS; além disso, para um mesmo domínio, há um limite adicional. A documentação, após retestes, também menciona dois pontos: palavras-chave com caracteres corrompidos ainda podem retornar alguns resultados e mesmo assim serem cobradas normalmente; alguns sites retornam a página inicial para páginas inexistentes (soft 404), e o Fetch trata isso como uma requisição bem-sucedida, cobrando por ela. Antes de fazer o fetch, é melhor filtrar os links você mesmo.

🎯 Dica técnica: Em cenários que precisam citar o texto original entre rodadas, sugiro primeiro validar de ponta a ponta a cadeia “search → fetch → deepseek-flash” no APIYI (apiyi.com) usando a cota de teste gratuita para novos usuários; depois de confirmar que o comprimento do conteúdo extraído e o número de requisições cobradas estão dentro do esperado, coloque em produção.


O que observar quando a chave do deepseek-flash não vem do site oficial

Um ponto precisa ficar claro: até 2026-11-15, nem a tabela geral de modelos nem as atualizações em tempo real da APIYI indicam que o deepseek-flash já suporte deepseek_web_search. O item mais recente relacionado ao DeepSeek nas atualizações em tempo real é o lançamento da versão econômica em 2026-11-11; em 13 de novembro essa API de App ainda não havia aparecido. Por isso, ao chamar o deepseek-flash na APIYI, não dá para assumir que basta declarar deepseek_web_search para que ele faça a busca sozinho — hoje o papel dele é de modelo de resposta.

A tabela abaixo traz os preços de 2026-11-15, com o valor de token em USD / 1 milhão de tokens e os modelos cobrados por chamada em USD / chamada:

Modelo Preço na APIYI apiyi.com Comparação com o site oficial Observações
deepseek-flash Entrada 0.3, saída 1.2, leitura de cache 0.006 Em horário de pico, igual: 0.3 / 1.2 / 0.006; fora de pico, pela metade A tabela geral não traz o preço pela metade fora de pico
deepseek-search 0.0009 / chamada (ou seja, 0.90 / 1000 chamadas) 0.75 / 1000 chamadas Grupos apenas default e svip
deepseek-fetch 0.0009 / chamada (ou seja, 0.90 / 1000 chamadas) 0.75 / 1000 chamadas Grupos apenas default e svip

Os 0.90 USD / 1000 chamadas que aparecem na página de capacidades e os 0.0009 USD / chamada da tabela geral são o mesmo preço. Segundo a documentação da APIYI, já contando o bônus de recarga, grandes clientes que recarregam pagam na prática cerca de 0.75 USD / 1000 chamadas, o que fica igual ao site oficial; usuários comuns pagam cerca de 0.82 USD / 1000 chamadas. Esses dois números são valores já ajustados pelo bônus, não o preço da tabela geral. Os preços incluem impostos e é possível emitir nota fiscal.

Além disso, OCR, ASR e TTS ainda não estão disponíveis na APIYI; vamos disponibilizar esse modelo o mais rápido possível. Modelos e preços devem ser conferidos na lista de modelos da plataforma.

💡 Sugestão de escolha: se o seu negócio precisa do “o próprio modelo faz várias buscas em etapas” com a busca embutida do site oficial, por enquanto é preciso usar a chave do site oficial. Se você valoriza mais o texto original poder ser retido e uma fatura previsível, use a interface independente da APIYI apiyi.com junto com o deepseek-flash para responder — aí todo o fluxo fica nas suas mãos.


FAQ — Perguntas Frequentes

P1: O que é a busca integrada do deepseek-flash?

É a ferramenta do lado do servidor `deepseek_web_search` disponível no deepseek-flash (V4.1-Flash-1017), utilizável nas três modalidades de protocolo: Messages, Responses e Chat Completions. A chamada da ferramenta e a montagem do contexto são feitas pelo servidor; a taxa da ferramenta é cobrada separadamente da taxa de tokens.

P2: Qual a diferença entre o deepseek-flash buscar sozinho e o programa chamar Search / Fetch?

A busca integrada é contada por query, e os resultados intermediários não passam para a próxima rodada; a interface independente é contada por requisição bem-sucedida, o `count` não afeta o preço, e o texto retornado fica a seu critério manter ou não. A primeira é mais simples de integrar, a segunda é mais controlável.

P3: Quando foi lançado esse conjunto de capacidades de acesso à web do deepseek-flash?

A DeepSeek lançou oficialmente em 13/11/2026 (22:24 no horário de Pequim), com a página de notícias e o changelog no mesmo dia. O `deepseek-search` e o `deepseek-fetch` na APIYI foram disponibilizados em 21/10/2026, o que não é o mesmo evento deste lançamento.

P4: A versão econômica ou o V4 Pro conseguem buscar sozinhos?

A documentação oficial afirma que esse conjunto de capacidades conversacionais é oferecido apenas no deepseek-flash, então não o aplique ao deepseek-v4-pro nem ao ID da versão econômica. A versão econômica `deepseek-v4-1-flash-economy-261017` da APIYI carrega os mesmos pesos do V4.1-Flash-1017, apenas com velocidade menor. A estimativa descrita na documentação é de cerca de 2 segundos para o primeiro token e cerca de 15 milissegundos por token. Não é uma interface de busca.

P5: Como fazer o deepseek-flash responder com base em páginas web na APIYI?

Use um token `default` ou `svip` para chamar `/v1/tools/search` e `/v1/tools/fetch`, monte o texto retornado dentro de messages e depois chame o `deepseek-flash`. Para os parâmetros específicos, consulte a página DeepSeek Search / Fetch no centro de documentação da APIYI em apiyi.com.

P6: Ao oferecer o serviço externamente, o que devo observar nas configurações de segurança?

A documentação oficial exige que, ao oferecer o serviço externamente, o `safety_check` esteja ativado (o exemplo da documentação usa level como high), além de concluir por conta própria a revisão de segurança de conteúdo, o registro do modelo de linguagem grande e a rotulagem de IA. Depois de ativado, parâmetros de amostragem como `temperature` são ignorados, e quando o modelo recusa responder, o `stop_reason` é `refusal`. A segurança do modelo é cobrada por token de saída, sem preço unitário separado.

P7: Se nenhuma query retornar resultados, ainda serei cobrado?

Falhas ou ausência de resultados na busca integrada não são cobradas. A interface independente só cobra quando há HTTP 200 e resultados; 400 e 404 de falha na captura não são cobrados. Mas o reteste da documentação menciona que palavras-chave embaralhadas e soft 404 ainda podem ser cobrados.


deepseek-flash busca, mas também esquece: principais conclusões

  • O pensamento muda a forma de buscar: com o pensamento desligado, é uma busca com citações; com o pensamento ligado, é uma busca de raciocínio profundo em várias etapas.
  • Os links não são necessariamente lidos: quando o pensamento está ligado e deepseek_web_search foi declarado, os links não são lidos individualmente.
  • A cobrança é contada por query: três queries dentro de uma única busca contam como três; falhas ou resultados vazios não são cobrados.
  • Para conciliar, olhe o campo tool: web_search_requests serve apenas para exibição; o número de cobranças aparece em campos como tool_search.
  • Na rodada seguinte só resta a resposta: páginas web, páginas e o raciocínio são descartados; o “esquecer” se refere ao contexto.
  • Se quiser manter a página, faça a busca você mesmo: no APIYI apiyi.com, use deepseek-search mais deepseek-fetch e depois entregue o resultado ao deepseek-flash.

Resumo

O deepseek-flash busca e também esquece. Fique atento a três coisas:

  1. Pensamento: a mesma declaração de deepseek_web_search percorre dois fluxos diferentes conforme o interruptor de pensamento, e o comportamento de leitura dos links muda junto.
  2. Cobrança: as ferramentas integradas contam por query, imagem e região selecionada; a API independente conta por requisição bem-sucedida. Não misture as duas unidades no mesmo cálculo.
  3. Próxima rodada: só o corpo da resposta é mantido. Se precisar citar o conteúdo original entre rodadas, o próprio programa deve buscar e salvar esse conteúdo.

Se a sua chave está no APIYI, a documentação atual não afirma que o deepseek-flash já tenha busca integrada disponível. Você pode primeiro rodar a combinação da API independente do APIYI apiyi.com com o deepseek-flash usando a cota gratuita, e só depois decidir se precisa da busca integrada do site oficial.


📚 Materiais de referência

  1. Página de notícias da DeepSeek (2026-11-13): anúncio da abertura dos recursos do App para a API
  2. Link: api-docs.deepseek.com/zh-cn/news/news261113
  3. Descrição: confirma que somente o deepseek-flash possui esse conjunto de capacidades

  4. Guia Build a Chatbot da DeepSeek: comparação de comportamento entre o interruptor de raciocínio e as combinações de ferramentas

  5. Link: api-docs.deepseek.com/guides/build_a_chatbot
  6. Descrição: regras de busca com raciocínio profundo, leitura de links e contexto em múltiplas rodadas

  7. Guia Web Tools da DeepSeek: uso e cobrança (Usage and Billing) das ferramentas integradas

  8. Link: api-docs.deepseek.com/guides/web_tools
  9. Descrição: cobrança por número de queries e significado dos campos de usage

  10. Página de preços da DeepSeek: preço por token, horário de pico e fora de pico, preço unitário das ferramentas

  11. Link: api-docs.deepseek.com/quick_start/pricing
  12. Descrição: dados de 2026-11-15

  13. Documentação DeepSeek Search / Fetch da APIYI: parâmetros e cobrança da interface independente

  14. Link: docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview
  15. Descrição: requisitos de agrupamento, restrições de parâmetros e notas de reteste da documentação

  16. Tabela geral de modelos da APIYI: modelos e preços em tempo real

  17. Link: docs.apiyi.com/models
  18. Descrição: modelos e preços devem ser consultados nesta página como referência

Autor: Equipe técnica da APIYI
Contato técnico: fale conosco pela página inicial do APIYI apiyi.com; mais materiais estão disponíveis no centro de documentação docs.apiyi.com

Artigos relacionados

Similar Posts