Como usar a API do DeepSeek e quanto ela custa.

Por que a API do DeepSeek entrou no radar de quem olha custo

A DeepSeek é uma empresa chinesa que desenvolve modelos de IA. Ela chamou atenção no Brasil pelo preço por token, que costuma ficar abaixo do praticado pelos modelos de topo dos laboratórios americanos. Para quem processa volume — classificar mensagens, resumir conversas, extrair campos de documento, marcar leads — essa diferença aparece direto no orçamento.

Escolher por preço não é amadorismo. Costuma ser a decisão certa quando a tarefa é repetitiva, o resultado é verificável e o erro é barato de corrigir. O cuidado é outro: preço por token não é o mesmo que custo por tarefa. Um modelo mais barato que erra e exige nova chamada pode sair mais caro que um modelo caro que acerta de primeira.

O que move a conta é a combinação de preço de entrada, preço de saída, tamanho do seu prompt e quantidade de tokens que o modelo gasta para responder. Prompt grande repetido milhares de vezes por dia costuma pesar mais do que a escolha do modelo.

• Meça tokens de entrada e de saída do seu prompt real, não de um exemplo curto.
• Separe as tarefas de volume das tarefas críticas antes de escolher modelo.
• Some o retrabalho: uma resposta errada custa a segunda chamada mais o tempo de quem revisa.
• Compare a tabela de preços vigente do provedor no dia em que for decidir, não a que você leu no mês passado.

Como criar a conta e a chave da API DeepSeek

A conta do chat e a conta da API são coisas diferentes. Para integrar, você precisa da plataforma de desenvolvedores da DeepSeek, em platform.deepseek.com. Lá ficam o saldo, o consumo e a área de chaves.

O fluxo é curto: cria a conta, adiciona crédito, gera a chave na área de API keys e copia o valor. A chave completa aparece só no momento da criação. Se você fechar a janela sem copiar, o caminho é apagar e criar outra.

O pagamento é internacional, em moeda estrangeira. Isso significa cartão internacional, IOF e variação cambial entre a recarga e o fechamento da fatura. Vale colocar esses itens na conta antes de dizer que ficou barato.

• Crie uma chave por projeto ou ambiente, com nome que identifique onde ela é usada.
• Guarde a chave em variável de ambiente, nunca no repositório, no print ou no front-end.
• Confira o saldo antes do primeiro teste: sem crédito, a chamada falha mesmo com a chave certa.
• Se a chave vazar, revogue primeiro e investigue depois.

A primeira chamada: o formato é o mesmo da OpenAI

A API do DeepSeek segue o formato de chat completions da OpenAI. Na prática, se o seu código já usa o SDK da OpenAI, o que muda é a URL base, a chave e o identificador do modelo. Quem já integrou uma API nesse padrão não encontra novidade aqui.

Teste primeiro no terminal, antes de mexer na aplicação. Uma chamada isolada separa os problemas: se ela funciona, o que estiver quebrado está no seu código, não na credencial.

• Status 401 ou 403: problema de chave. Confira espaços extras e se ela continua ativa.
• Status 400: problema no corpo da requisição ou no nome do modelo.
• Status 402 ou mensagem de saldo: falta crédito na conta.
• Resposta com texto: leia em choices[0].message.content.

curl https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"Responda apenas: chave funcionando"}]
  }'

As diferenças práticas entre os modelos da família DeepSeek

De forma geral, a família tem dois perfis. Um modelo de uso geral, que responde direto e tem custo mais previsível. E um modelo de raciocínio, que gasta tokens antes de responder — ele tende a ir melhor em problemas com etapas, e produz mais tokens de saída, o que aumenta o custo e o tempo de resposta.

Não citamos benchmark aqui. Número de avaliação envelhece rápido e quase nunca descreve a sua tarefa. O teste que decide é o seu, com os seus dados.

Os identificadores mudam de versão para versão. Copie o nome exato na documentação oficial da DeepSeek ou, se for usar pela Roteia, no catálogo em /modelos/. Não presuma que um modelo anunciado pelo laboratório já está liberado em qualquer serviço.

Vale olhar também o cache de prompt. Quando o começo do seu prompt se repete em toda chamada, parte da entrada pode ser cobrada de forma diferente. Confirme a regra na documentação do provedor: isso muda a conta de quem manda instruções longas e fixas.

• Tarefa objetiva e de volume: comece pelo modelo geral.
• Tarefa com várias etapas de lógica: teste o modelo de raciocínio e compare o custo real.
• Contexto longo custa caro na entrada. Corte o que o modelo não precisa ler.
• Monte um conjunto de casos reais do seu produto e rode nos dois. A diferença aparece na sua planilha, não em um ranking.

Existe API do DeepSeek grátis?

Essa é uma das buscas mais comuns, então a resposta precisa ser direta: a API oficial da DeepSeek é paga, cobrada por token. Não há camada gratuita permanente na plataforma oficial.

O que existe são outras coisas com nomes parecidos. Créditos promocionais de entrada, que acabam. Interfaces de chat sem custo, que não servem para integrar. E serviços de terceiros que hospedam os pesos abertos do DeepSeek e oferecem acesso gratuito, normalmente com limite de requisições, fila em horário de pico ou uso do que você envia para treinar modelos.

Os modelos do DeepSeek têm pesos publicados, então rodar por conta própria é possível. Nesse caminho o custo deixa de ser por token e vira GPU, engenharia e manutenção. Para empresa pequena com volume moderado, esse desvio costuma sair mais caro que pagar por chamada.

• Se um serviço oferece o modelo de graça, procure nos termos a parte sobre uso e retenção dos dados.
• Se essa parte não estiver escrita, pergunte antes de mandar qualquer coisa de cliente.
• Antes de adotar uma opção gratuita, leia o limite de requisições publicado e rode o seu volume de um dia contra ele.

Antes de enviar dado sensível para um provedor estrangeiro

Toda chamada de API manda o seu texto para o servidor de outra empresa. Isso vale para qualquer provedor fora do Brasil, americano ou chinês, e vale também quando a chamada passa por um intermediário.

A DeepSeek é uma empresa chinesa. A política de privacidade dela descreve onde os dados são armazenados e processados, e é ela que deve ser lida, na versão vigente, antes da decisão. Esse é um fato para entrar na sua análise, do mesmo jeito que a jurisdição de um provedor americano entra. Não é motivo automático para descartar, nem detalhe para ignorar.

Pela LGPD, enviar dado pessoal para fora do país é transferência internacional. Você precisa de base legal, precisa informar o titular e continua responsável pelo que mandou, independentemente de qual fornecedor processou.

O caminho prático quase sempre é o mesmo: mandar menos. Boa parte dos prompts carrega CPF, telefone, nome completo e número de contrato que o modelo não usa para nada.

• Classifique o dado antes de integrar: público, interno, pessoal ou sensível.
• Remova ou substitua identificadores que não mudam a resposta do modelo.
• Verifique retenção e se a entrada é usada para treino no provedor escolhido.
• Registre a decisão por escrito, com data e responsável.
• Dado de saúde, financeiro ou de menor: envolva o jurídico antes do primeiro teste.
• Leia um prompt real do seu produto como se fosse um e-mail para um fornecedor externo. O que você não mandaria por e-mail, não mande na API.

Como ficaria usar o DeepSeek pela Roteia, com preço em Real

A Roteia é um gateway brasileiro de APIs de IA, com uma API compatível com o formato da OpenAI. Quais modelos estão liberados, inclusive os da família DeepSeek, é o catálogo em /modelos/ que responde, com o preço final em Real ao lado de cada um. Confira lá antes de planejar a integração.

O que muda é a operação: cadastro em app.roteia.ai, saldo pré-pago em Real, recarga por Pix, boleto ou cartão conforme a disponibilidade no painel, NFS-e mediante solicitação e suporte em português por suporte@roteia.ai. Você também deixa de manter conta e saldo em cada laboratório separadamente.

O que não muda merece a mesma clareza: o modelo continua rodando na infraestrutura de quem o publica. A Roteia é a camada de autenticação, roteamento e cobrança — ela não altera onde o processamento acontece. Se a sua conclusão na seção anterior foi não enviar determinado dado, ela continua valendo aqui do mesmo jeito.

A Roteia é independente e não pertence nem representa OpenAI, Anthropic, Google, DeepSeek ou OpenRouter. A lógica de cobrança está em /precos/, o passo a passo em /docs/primeira-chamada/, o checklist de troca de endpoint em /docs/migrar-openrouter/, a visão geral da camada em /gateway-llm/ e as práticas de segurança em /seguranca/. A chamada é a mesma que você já testou: muda a URL base, a chave e o identificador do modelo. O exemplo abaixo usa um ID de exemplo, então copie o ID exato no catálogo antes de rodar.

• Confira em /modelos/ se o modelo que você quer está no catálogo e copie o ID exato.
• Compare o preço em Real com o que você paga hoje, incluindo IOF e câmbio. Se não compensar, não migre.

curl https://api.roteia.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROTEIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role":"user","content":"Responda apenas: integração concluída"}]
  }'