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.
Se a dúvida ainda é qual canal usar, comece pelo guia do DeepSeek em português do Brasil e volte a esta documentação quando a escolha for a API.
Atualização documental — 23 de agosto de 2026. A API hospedada publica três IDs:
deepseek-v4-flash,deepseek-v4-proe o experimentaldeepseek-v4-flash-vision-exp. As versões atuais sãoDeepSeek-V4-Flash-0731,DeepSeek-V4-Pro-0813eDeepSeek-V4-Flash-Vision-Exp. Os três aparecem em Chat Completions, Responses API e Anthropic API; somente o Vision Exp processa imagens. Resultados autenticados de 29/07 e 05/08 abaixo continuam como registros históricos e não foram repetidos nem recalculados.
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.
Situação posterior à auditoria — 23/08/2026: a documentação oficial agora lista também
deepseek-v4-flash-vision-exp, lançado em 21/08. Isso não altera o resultado deGET /modelsobservado em 29/07. O HTTP 400 com Pro na Responses API em 05/08 também continua histórico, anterior ao Pro-0813; o suporte documentado atual inclui Flash, Pro e Vision Exp.
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, deepseek-v4-pro e deepseek-v4-flash-vision-exp |
| Versões hospedadas | DeepSeek-V4-Flash-0731, DeepSeek-V4-Pro-0813 e DeepSeek-V4-Flash-Vision-Exp |
| Entrada de imagem | Somente com deepseek-v4-flash-vision-exp; JPEG, PNG, GIF e WebP |
| Files API | Upload e reutilização de imagens por file_id; não aceita PDF como base de conhecimento |
| Autenticação | Chave da DeepSeek mantida no backend |
| Thinking Mode | Disponível e ativado por padrão; esforço padrão high |
| 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 | Imagens | Limite principal |
|---|---|---|---|
| Chat Completions | Flash, Pro e Vision Exp | Sim, com Vision Exp, por URL, base64 ou file_id | Use os blocos de conteúdo e parâmetros publicados pela DeepSeek |
| Responses API | Flash, Pro e Vision Exp | Sim, com Vision Exp, em input_image por image_url ou file_id | É stateless; previous_response_id, conversation e store não oferecem estado hospedado |
| Anthropic Messages | Flash, Pro e Vision Exp | Sim, com Vision Exp, por base64, URL ou arquivo | Compatibilidade parcial; blocos document e mcp_servers não são suportados |
Arquivos genéricos de entrada não são suportados na Responses API. A Files API atual armazena imagens para uso com o Vision Exp; ela não transforma PDFs ou documentos em uma base de conhecimento. Parâmetros não suportados podem ser ignorados sem erro, portanto HTTP 200 não prova que um campo teve efeito.
Modelos atuais: Flash, Pro ou Vision Exp?
| Critério | deepseek-v4-flash | deepseek-v4-pro | deepseek-v4-flash-vision-exp |
|---|---|---|---|
| Versão atual | Flash-0731 | Pro-0813 | Flash-Vision-Exp |
| Status / foco | Texto, velocidade, volume e menor custo | Texto, tarefas complexas e maior qualidade | Experimental; texto e compreensão de imagens |
| Entrada | Texto | Texto | Texto e imagens JPEG, PNG, GIF e WebP |
| Contexto | 1M tokens | 1M tokens | 1M tokens |
| Saída máxima | 384K | 384K | 384K |
| Thinking / Non-Thinking | Sim / sim | Sim / sim | Sim / sim |
| Chat / Responses / Anthropic | Sim / sim / sim | Sim / sim / sim | Sim / sim / sim |
| Concorrência por conta | 2.500 | 500 | 2.500 |
Comece com V4 Flash em tarefas de texto e use o Pro quando uma avaliação demonstrar ganho que justifique o custo. Escolha Vision Exp somente quando houver entrada visual; ele é experimental e usa as mesmas tarifas do Flash.
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 hospedada atual apresenta os IDs explícitos deepseek-v4-flash, deepseek-v4-pro e deepseek-v4-flash-vision-exp. 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.
Chamada com imagem no Vision Exp
Use o ID experimental deepseek-v4-flash-vision-exp apenas quando a entrada realmente contiver imagem. Em Chat Completions, envie blocos de conteúdo text e image_url; a imagem pode vir de URL pública, data URL em base64 ou de um file_id criado previamente.
Aceite apenas URLs e arquivos autorizados. A DeepSeek detecta o formato pelo conteúdo real, não apenas pela extensão ou pelo MIME declarado. Consulte o exemplo oficial de Vision.
Vision e Files API
O deepseek-v4-flash-vision-exp recebe JPEG, PNG, GIF e WebP. Em Chat Completions, a imagem pode ser enviada como URL pública, data URL em base64 ou bloco file com um file_id. Na Responses API, use um bloco input_image com image_url ou file_id. No formato Anthropic, use um bloco image com fonte base64, URL ou arquivo.
A Files API aceita imagens de até 64 MiB com purpose="user_data". O prazo opcional de expiração vai de 1 hora a 30 dias; se ele for omitido, o arquivo permanece armazenado até ser excluído. Não apresente esse recurso como upload de PDF, RAG, embeddings ou vector store.
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 low, 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 em reasoning_content, enquanto content contém a resposta final. Se a requisição incluir o parâmetro tools, preserve reasoning_content de toda mensagem assistant e reenvie-o integralmente em todas as interações subsequentes, mesmo quando o modelo não realizar uma Tool Call naquela rodada; omiti-lo pode causar HTTP 400. Sem tools, o reasoning_content de turnos anteriores pode ser omitido e, se for enviado, será ignorado. Quando houver Tool Calls, preserve também tool_calls e mantenha content como uma string não nula. 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: as tarifas de pico e fora de pico estão em vigor desde 16/08/2026, às 16:00 UTC. O pico ocorre das 01:00 às 04:00 UTC e das 06:00 às 10:00 UTC, de segunda a sexta-feira; todos os demais horários são fora de pico. Valores de testes anteriores permanecem com a tarifa da data da coleta. Consulte o guia de preços atualizado.
Registro histórico: tarifas encerradas em 16/08/2026, 15:59 UTC
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.
Tarifas atuais por 1 milhão de tokens
| Modelo e período | Cache hit | Cache miss | Saída |
|---|---|---|---|
| Flash / Vision — fora de pico | US$ 0,007 | US$ 0,22 | US$ 0,66 |
| Flash / Vision — pico | US$ 0,014 | US$ 0,44 | US$ 1,32 |
| Pro — fora de pico | US$ 0,022 | US$ 0,66 | US$ 1,98 |
| Pro — pico | US$ 0,044 | US$ 1,32 | US$ 3,96 |
Consulte a página de preços antes de fechar um orçamento. Imagens são convertidas em tokens e cobradas como entrada no Vision Exp.
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, 500 para V4 Pro e 2.500 para V4 Flash Vision Exp. 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 um ID explícito atual:
deepseek-v4-flashoudeepseek-v4-propara texto;deepseek-v4-flash-vision-expquando houver imagem. Não inicie 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 deepseek-v4-flash, deepseek-v4-pro e deepseek-v4-flash-vision-exp.
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: 23 de agosto de 2026. As chamadas autenticadas acima permanecem datadas de 29 de julho; o teste de Responses permanece datado de 5 de agosto. Modelos, preços, limites e termos podem mudar.
Atualizações oficiais de 21–23/08/2026: Vision, Files API, Responses API e Change Log.