A DeepSeek API permite integrar os modelos hospedados da DeepSeek a backends, chatbots, agentes, produtos SaaS e automações. Este guia em português brasileiro reúne o que você precisa confirmar antes de implementar: modelos atuais, endpoint, autenticação, Thinking Mode, preços, cache, limites e a migração correta dos nomes antigos.
Auditoria prática da DeepSeek API em 29 de julho de 2026
Para separar documentação de comportamento observado, executamos uma bateria curta de chamadas autenticadas com uma chave temporária dedicada. A evidência abaixo é uma fotografia de uma conta e de um momento específico, não uma garantia de disponibilidade futura.
Resultado principal:
GET /modelsanunciou apenasdeepseek-v4-flashedeepseek-v4-pro. Ainda assim,deepseek-chatedeepseek-reasonerresponderam HTTP 200 nesta conta e retornaramdeepseek-v4-flashno campomodel. Tratamos isso como compatibilidade legada observada, não como suporte garantido.
| Teste | Configuração | Resultado observado | Uso | Latência |
|---|---|---|---|---|
| Catálogo | GET /models | HTTP 200; somente V4 Flash e V4 Pro | — | 499 ms |
| JSON Output | Flash; Thinking desativado | HTTP 200; {"status":"ok"}; parse local aprovado | 49 / 5 / 54 | 325 ms |
deepseek-chat | Prompt curto | HTTP 200; modelo retornado V4 Flash; sem reasoning | 12 / 1 / 13 | 317 ms |
deepseek-reasoner | Prompt curto | HTTP 200; modelo retornado V4 Flash; reasoning presente | 12 / 41 / 53; 39 reasoning | 278 ms |
| Validação | messages: [] | HTTP 400; Empty input messages | — | 312 ms |
Como interpretar os aliases depois do prazo anunciado
O prazo oficial de 24 de julho de 2026 já passou. O teste mostra que os dois nomes ainda eram aceitos cinco dias depois nesta conta, embora estivessem ausentes de GET /models. Isso não altera a recomendação de implementação: use deepseek-v4-flash ou deepseek-v4-pro explicitamente. Compatibilidade observada não é contrato de suporte.
Hashes SHA-256 dos testes de aliases
deepseek-chat— requisição:3cca100c3878856b89106fff584b9f42fbf33d9096fdae3a693cfdd45ec132fbdeepseek-chat— resposta:49de270377cbce2b6e06fecb8d4c2525d8fd3ac0da6ebd2387c988f0228120c5deepseek-reasoner— requisição:69d67a85dfc759d0656ee166c69e0950ed2baefeaa4ffaeb3bee6a18736bf352deepseek-reasoner— resposta:f04fddf782bd205f17c0bb375713ee5c465e425d17ae63a8b25174e594268424reasoning_content— hash:88e6975de815a2c093cbd73207213dfef4e7485f8448f429571ae8f1039e9e91
Metodologia e limites
- Base:
https://api.deepseek.com; endpointsGET /modelsePOST /chat/completions. - Chamadas não streaming, uma execução por condição; sem teste de carga, concorrência, região ou repetição estatística.
- O JSON foi analisado localmente. Nenhuma ação externa foi executada.
- O conteúdo bruto de
reasoning_contentnão é publicado; registramos presença, tamanho, tokens e hash. - Latências individuais são telemetria da amostra, não benchmark.
- A chave temporária foi criada apenas para a auditoria e revogada ao final.
Continue: catálogo de modelos, V4 Flash vs Pro, Thinking Mode, JSON Output, Tool Calls e Context Caching.
Fontes oficiais: Lists Models, Change Log e Models & Pricing.
Documentação reconferida em 5 de agosto de 2026: os IDs publicados continuam sendo
deepseek-v4-flashedeepseek-v4-pro; a tabela oficial identifica a versão hospedada do Flash comoDeepSeek-V4-Flash-0731. A DeepSeek também passou a documentar uma Responses API, compatível apenas com o Flash na data desta revisão. A auditoria autenticada abaixo permanece datada de 29 de julho de 2026 e não foi repetida nesta atualização documental.
Este é um guia independente em português. Não somos a DeepSeek e não representamos um canal oficial da empresa. Para decisões de produção, confirme mudanças na documentação oficial da DeepSeek API.
Resumo rápido da DeepSeek API
| Item | Valor atual |
|---|---|
| Base URL — formato OpenAI | https://api.deepseek.com |
| Base URL — formato Anthropic | https://api.deepseek.com/anthropic |
| Interfaces documentadas | Chat Completions, Responses API e Anthropic Messages |
| IDs hospedados | deepseek-v4-flash e deepseek-v4-pro |
| Versão hospedada do Flash | DeepSeek-V4-Flash-0731; o ID de chamada não mudou |
| Responses API | Somente V4 Flash em 05/08/2026; V4 Pro ainda não suportado |
| Autenticação | Chave da DeepSeek mantida no backend |
| Thinking Mode | Disponível e ativado por padrão; controles variam conforme a interface |
| Contexto / saída | Até 1M / até 384K, dentro da mesma janela total |
O que é a DeepSeek API?
A API é a interface programática da DeepSeek. Seu servidor envia instruções e dados autorizados, recebe uma resposta estruturada e mantém sob controle próprio autenticação, permissões, histórico, validação e regras de negócio. A compatibilidade de formato facilita usar clientes existentes, mas não transforma a DeepSeek em serviço da OpenAI ou da Anthropic e não garante suporte a todos os campos desses ecossistemas.
Qual interface escolher?
| Interface | Modelos documentados | Use quando | Limite principal |
|---|---|---|---|
| Chat Completions | V4 Flash e V4 Pro | Seu aplicativo trabalha com messages e precisa da integração geral da API | Recursos e parâmetros específicos precisam seguir a referência DeepSeek |
| Responses API | V4 Flash | O cliente espera responses.create(), eventos tipados ou as ferramentas compatíveis publicadas | É stateless; Pro, imagens, arquivos e vários campos não são suportados |
| Anthropic Messages | V4 Flash e V4 Pro | O cliente usa o Anthropic SDK ou uma ferramenta compatível com esse formato | Compatibilidade parcial; imagens, documentos e mcp_servers não são suportados |
Na Responses API, parâmetros não suportados podem ser ignorados sem erro. Não trate HTTP 200 como prova de que um campo, ferramenta ou política de estado produziu efeito. Consulte a matriz oficial da Responses API, a matriz do formato Anthropic e o nosso teste autenticado da DeepSeek Responses API em português antes de migrar um fluxo de produção.
Modelos atuais: V4 Flash ou V4 Pro?
| Critério | deepseek-v4-flash | deepseek-v4-pro |
|---|---|---|
| Posicionamento | Rápido, econômico e adequado a alto volume | Modelo mais forte para tarefas complexas |
| Parâmetros anunciados | 284B totais / 13B ativos | 1,6T totais / 49B ativos |
| Contexto | 1M tokens | 1M tokens |
| Thinking Mode | Sim | Sim |
| Uso inicial recomendado | Chat, classificação, resumo, extração e escala | Raciocínio avançado, coding e agentes complexos |
| Concorrência por conta | 2.500 conexões | 500 conexões |
Comece com o V4 Flash e meça qualidade, latência e custo no seu conjunto de testes. Adote o V4 Pro quando o ganho de qualidade justificar o custo maior. O Pro é uma atualização opcional; ele não deve ser apresentado como substituto automático do antigo deepseek-reasoner.
Migração correta de deepseek-chat e deepseek-reasoner
| Código legado | Mapeamento documentado na transição | Configuração nova explícita |
|---|---|---|
deepseek-chat | V4 Flash em Non-Thinking Mode | deepseek-v4-flash + thinking.type = disabled |
deepseek-reasoner | V4 Flash em Thinking Mode | deepseek-v4-flash + thinking.type = enabled |
Exemplo de substituição explícita para deepseek-reasoner:
{
"model": "deepseek-v4-flash",
"messages": [
{"role": "user", "content": "Analise este problema passo a passo."}
],
"thinking": {"type": "enabled"},
"reasoning_effort": "high"
}Se os seus testes mostrarem que a tarefa precisa de mais capacidade, você pode trocar o modelo para deepseek-v4-pro. Isso é uma decisão de qualidade e custo, não uma equivalência de migração.
DeepSeek R1 ainda é um ID da API?
Não. DeepSeek-R1 é uma família de modelos e checkpoints, mas não é um ID atual da API hospedada da DeepSeek. Em 2025, a documentação associava o R1 ao ID deepseek-reasoner. Durante a janela de compatibilidade de V4, esse alias foi mapeado para V4 Flash com Thinking Mode. A lista atual apresenta somente os IDs V4 explícitos. Não use deepseek-r1 no campo model de exemplos atuais.
Para entender os checkpoints, versões distilled e opções de execução própria, consulte o nosso guia do DeepSeek R1.
Como criar uma chave de API com segurança
- Acesse a área oficial de API keys.
- Crie uma chave para o ambiente correto.
- Guarde-a em uma variável de ambiente ou gerenciador de segredos.
- Faça a chamada somente no backend, em uma função serverless ou em outro ambiente confiável.
- Rotacione imediatamente qualquer chave exposta.
Nunca coloque a API key em JavaScript entregue ao navegador, aplicativo distribuído sem proteção, repositório público, print, log ou mensagem de erro.
Primeira chamada com cURL
O exemplo abaixo usa o V4 Flash em Non-Thinking Mode para produzir uma resposta curta. A variável DEEPSEEK_API_KEY deve existir no ambiente do terminal.
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-d '{
"model": "deepseek-v4-flash",
"messages": [
{"role": "system", "content": "Responda em português brasileiro."},
{"role": "user", "content": "Explique a DeepSeek API em duas frases."}
],
"thinking": {"type": "disabled"},
"max_tokens": 300,
"stream": false
}'Para um tutorial detalhado sobre mensagens, resposta, streaming e SDKs, leia DeepSeek Chat Completions API. Para um projeto completo com frontend e backend, avance para como construir um aplicativo com a DeepSeek API.
Thinking Mode: ativação e parâmetros
O Thinking Mode está ativado por padrão. No formato OpenAI, use {"thinking":{"type":"enabled"}} ou {"thinking":{"type":"disabled"}}. Quando o pensamento estiver ativo, reasoning_effort aceita high ou max.
Atenção: em Thinking Mode,
temperature,top_p,presence_penaltyefrequency_penaltynão produzem efeito. A API pode aceitá-los por compatibilidade, sem erro, mas eles não alteram a resposta.
O raciocínio é retornado no campo reasoning_content e a resposta final em content. Quando uma rodada de Thinking Mode inclui Tool Calls, preserve o reasoning_content ao reenviar a mensagem do assistente; do contrário, a API pode retornar erro 400. Veja o guia específico do Thinking Mode.
JSON Output, Tool Calls, streaming e cache
JSON Output
Use response_format: {"type":"json_object"} quando o backend precisar analisar um JSON válido. Inclua a palavra “json” e um formato esperado no prompt, defina max_tokens suficiente e valide o objeto recebido antes de salvar ou executar qualquer ação.
Tool Calls
O modelo pode solicitar uma função, mas não a executa. Seu backend deve validar o nome da ferramenta, argumentos, permissões e impacto da ação. Use allowlists e confirmação humana para operações sensíveis. Consulte o guia de DeepSeek Tool Calls.
Streaming
Com stream: true, a API envia eventos SSE parciais e encerra com data: [DONE]. Streaming melhora a percepção de velocidade em chats, mas respostas estruturadas costumam ser mais simples de validar sem streaming.
Context Caching
O cache em disco está ativado automaticamente e reaproveita unidades persistidas de prefixos de entrada. Ele não reutiliza uma resposta pronta. Meça acertos e falhas em usage.prompt_cache_hit_tokens e usage.prompt_cache_miss_tokens. O comportamento é de melhor esforço; veja o nosso guia de DeepSeek Context Caching.
Preços atuais da API
Os valores abaixo foram conferidos em 29 de julho de 2026 e são cobrados em dólares por 1 milhão de tokens. Não são apresentados como promoção: use a tabela vigente na data da sua recarga.
| Modelo | Entrada com cache hit | Entrada com cache miss | Saída |
|---|---|---|---|
deepseek-v4-flash | US$ 0,0028 | US$ 0,14 | US$ 0,28 |
deepseek-v4-pro | US$ 0,003625 | US$ 0,435 | US$ 0,87 |
Preços podem mudar. Antes de estimar orçamento ou recarregar saldo, confira Models & Pricing na documentação oficial.
Rate limits e isolamento por usuário
A documentação atual informa limite de concorrência de 2.500 conexões por conta para V4 Flash e 500 para V4 Pro. O cálculo é feito no nível da conta, independentemente de quantas API keys existam. Ao ultrapassar o limite, a resposta é HTTP 429.
- Implemente fila e limite de concorrência no seu backend.
- Use retry com exponential backoff e jitter apenas para falhas transitórias.
- Defina timeout e trate conexões keep-alive.
- Monitore 429, 500, 503, latência e custo por tarefa.
- Se usar
user_id, envie um identificador pseudônimo com até 512 caracteres e nunca inclua dados pessoais.
Privacidade, segurança e responsabilidade
Quem cria um produto com a API é responsável pelo que coleta de seus próprios usuários. Os termos da Open Platform esclarecem que a política de privacidade da DeepSeek para o titular da conta não cobre automaticamente as regras de tratamento de dados dos usuários do seu aplicativo. Publique sua própria política, informe fornecedores e finalidades, minimize dados e ofereça os direitos aplicáveis.
- Não envie senhas, chaves, segredos ou dados pessoais desnecessários.
- Redija ou anonimize conteúdo sensível antes da chamada.
- Não prometa “zero logs”, “zero treinamento” ou retenção inexistente sem um compromisso contratual verificável.
- Valide respostas e mantenha revisão humana em decisões de alto impacto.
- Não apresente seu produto como oficial, autorizado ou endossado pela DeepSeek.
Leia os Termos da DeepSeek Open Platform e mantenha a política de privacidade do seu serviço coerente com a implementação real.
Checklist antes de publicar
- Use
deepseek-v4-flashoudeepseek-v4-pro, sem novos projetos em aliases legados. - Se estiver migrando de
deepseek-reasoner, teste primeiro V4 Flash com Thinking ativado. - Mantenha a chave exclusivamente no servidor.
- Valide entrada, saída, JSON e argumentos de ferramentas.
- Defina limites de tamanho, custo, tempo e concorrência.
- Registre métricas sem gravar conteúdo sensível por padrão.
- Teste qualidade em português brasileiro com dados representativos.
- Confirme modelos, preços e termos oficiais na data do lançamento.
Perguntas frequentes
Qual é o modelo padrão para uma nova integração?
Para a maioria dos protótipos e tarefas de alto volume, comece com deepseek-v4-flash. Compare com deepseek-v4-pro quando a tarefa exigir qualidade adicional.
Deepseek-reasoner foi substituído pelo V4 Pro?
Não. Durante a janela de compatibilidade documentada, deepseek-reasoner foi mapeado para V4 Flash com Thinking Mode ativado. V4 Pro continua sendo uma atualização opcional, não uma substituição equivalente automática.
DeepSeek R1 é um model ID atual?
Não na API hospedada atual da DeepSeek. R1 continua relevante como família e checkpoints abertos, mas os IDs hospedados vigentes são V4 Flash e V4 Pro.
Temperature funciona no Thinking Mode?
Não. temperature, top_p, presence_penalty e frequency_penalty são ignorados no Thinking Mode atual, embora possam ser aceitos sem erro por compatibilidade.
A API é gratuita?
A API é cobrada por tokens. Eventual saldo concedido deve ser conferido no painel da conta; não existe nesta página uma promessa de crédito gratuito universal.
Fontes oficiais consultadas
- Lançamento do DeepSeek V4 e aposentadoria dos aliases
- Modelos, preços e limites atuais
- Thinking Mode
- Rate Limit & Isolation
- Referência de Chat Completions
Última verificação documental: 5 de agosto de 2026. As chamadas autenticadas acima permanecem datadas de 29 de julho de 2026. Modelos, preços, limites e termos podem mudar.