Migração para DeepSeek V4 agora é uma tarefa de limpeza orientada por prazo, não apenas uma atualização de modelo. A documentação oficial da API da DeepSeek informa que os aliases antigos deepseek-chat e deepseek-reasoner serão totalmente descontinuados e ficarão inacessíveis após 24 de julho de 2026 às 15:59 UTC. Os IDs de modelo V4 suportados são deepseek-v4-flash e deepseek-v4-pro.
A boa notícia é que isso deve ser uma mudança de configuração controlada para muitas equipes. A DeepSeek diz para manter o mesmo base_url direto e atualizar o nome do modelo. Se você roteia modelos pelo Flatkey, use a mesma ideia: mantenha seu app apontando para https://router.flatkey.ai/v1, substitua o alias por uma linha atual de modelo DeepSeek V4 do Flatkey e verifique o comportamento da resposta, o modo de raciocínio, os logs de uso, a precificação e o rollback antes de mover o tráfego de produção.
Esta lista de verificação de migração para DeepSeek V4 oferece as etapas concretas: mapear aliases antigos, escolher deepseek-v4-flash ou deepseek-v4-pro, testar o comportamento com e sem raciocínio, atualizar a configuração do SDK e evitar uma troca de modelo não revisada perto da data limite.
Resposta Rápida: O Que Muda Em Uma Migração Para DeepSeek V4?
A mudança urgente é a string do modelo. Não deixe código de produção, variáveis de ambiente, roteadores de prompts, jobs de avaliação ou políticas de fallback fixados em deepseek-chat ou deepseek-reasoner.
| Antigo Alias | Comportamento Oficial Atual | Destino de Migração Para Testar | Risco a Verificar |
|---|---|---|---|
deepseek-chat |
Atualmente roteia para o modo sem pensamento de deepseek-v4-flash |
deepseek-v4-flash com pensamento desativado, a menos que você escolha intencionalmente outro modo V4 |
Estilo da saída, latência, custo, compatibilidade do parser e quaisquer parâmetros ignorados |
deepseek-reasoner |
Atualmente roteia para o modo de pensamento de deepseek-v4-flash |
deepseek-v4-flash ou deepseek-v4-pro com pensamento testado explicitamente |
reasoning_content, uso de tokens, tratamento de múltiplas interações e suporte do SDK |
| Nomes de modelos no estilo Claude na API Anthropic da DeepSeek | A DeepSeek mapeia nomes de Claude Opus para V4 Pro e nomes de Claude Haiku/Sonnet para V4 Flash | Prefira IDs explícitos de modelos DeepSeek V4 onde sua camada de roteamento permitir | Campos Anthropic não suportados, suporte a conteúdo de imagem/documento e comportamento de chamadas de ferramentas |
Para uma chamada direta à DeepSeek, a URL base oficial no formato OpenAI continua sendo https://api.deepseek.com. Para a Flatkey, a URL base do roteador continua sendo https://router.flatkey.ai/v1. Em qualquer um dos caminhos, a migração para DeepSeek V4 deve ser testada como uma mudança de modelo e de comportamento, e não apenas como uma substituição de texto.
Por que o prazo do alias importa
A página de prévia do V4 da DeepSeek informa que a API já está disponível; tanto deepseek-v4-pro quanto deepseek-v4-flash oferecem suporte a 1M de contexto e aos modos thinking e non-thinking, e os aliases antigos serão descontinuados após 24 de julho de 2026 às 15:59 UTC. Isso significa que um alias desatualizado pode passar de “funciona hoje” para “falha total” após a janela de descontinuação.
A tabela de início rápido da página inicial também lista deepseek-chat e deepseek-reasoner como aliases que serão descontinuados em 2026/07/24. Ela observa que, por compatibilidade, esses aliases correspondem aos modos non-thinking e thinking de deepseek-v4-flash.
Esse detalhe de compatibilidade é útil, mas não é motivo para esperar. Uma migração limpa para DeepSeek V4 migration dá tempo para comparar resultados, atualizar runbooks, treinar equipes de suporte e garantir que os painéis de produção exibam os novos IDs de modelo antes do prazo.
Roteamento Direto do DeepSeek versus Flatkey
Existem dois caminhos comuns de migração.
| Decisão | API DeepSeek Direta | DeepSeek via Flatkey |
|---|---|---|
| URL base | https://api.deepseek.com |
https://router.flatkey.ai/v1 |
| Chave de API | Chave de API DeepSeek | Chave de API Flatkey |
| Seleção de modelo | ID oficial do modelo DeepSeek | Linha atual do modelo DeepSeek na Flatkey |
| Benefício principal | Configuração direta com o provedor | Uma chave, um roteador, logs de uso compartilhados, cotas e visibilidade de faturamento entre provedores |
| Verificação em produção | Resposta do DeepSeek, modo de raciocínio, preços e erros | Resposta, status da rota, linha do modelo selecionado, log de uso, unidade de preço, cota e rollback |
O texto público do produto da Flatkey posiciona a plataforma em torno de uma chave de API, uma URL base compatível com OpenAI, preços claros, faturamento unificado e um único painel para chaves, uso e roteamento. Para equipes que já estão movendo tráfego de GPT, Claude, Gemini, Qwen, MiniMax e DeepSeek por um único gateway, uma migração para DeepSeek V4 é um bom momento para padronizar IDs de modelo e logging em toda a stack.
Verificação de catálogo Flatkey para DeepSeek V4
Para este artigo, verifiquei a API pública de preços da Flatkey em 16 de junho de 2026. A captura retornou 638 linhas totais de modelos e 19 linhas com nome DeepSeek. Ela सूचीu tanto deepseek-v4-pro quanto deepseek-v4-flash no grupo Standard com suporte ao endpoint openai.
Trate isso como uma prova de catálogo datada, e não como uma promessa de que sua conta e rota estão prontas. Na mesma captura, ambas as linhas V4 tinham o status de disponibilidade unknown_failure, o que significa que a disponibilidade deve ser confirmada na visualização atual de preços da Flatkey ou no painel antes que o tráfego real dependa da rota. Uma migração cuidadosa para DeepSeek V4 deve incluir um teste rápido ao vivo e uma verificação do log de uso no dia em que você fizer a troca.
Checklist de Migração do DeepSeek V4
Use esta checklist antes de substituir aliases em produção.
- Inventarie todos os aliases. Pesquise no código da aplicação, variáveis de ambiente, regras do prompt-router, configs de eval, jobs em segundo plano, notebooks, docs e runbooks de suporte por
deepseek-chatedeepseek-reasoner. - Classifique cada workload. Marque cada rota como chat, reasoning, uso de ferramentas por agente, saída estruturada, contexto longo, batch eval ou somente fallback. Não assuma que toda rota deve migrar para o mesmo modo V4.
- Escolha o modelo de destino. Comece com
deepseek-v4-flashquando quiser o substituto mais próximo dos aliases atuais. Avaliedeepseek-v4-proquando o workload precisar de mais capacidade e você puder aceitar o perfil de custo e latência após os testes. - Torne o thinking explícito. Para o comportamento antigo do
deepseek-chat, teste o modo sem thinking. Para o comportamento antigo dodeepseek-reasoner, teste o modo thinking e confirme como seu SDK lida comreasoning_content. - Mantenha os IDs de modelo na configuração. Coloque o modelo de destino em uma variável de ambiente ou tabela de roteamento, não embutido na lógica da aplicação.
- Execute testes de saída em pares. Compare as respostas do alias antigo com as novas respostas V4 em prompts representativos, parsers, tarefas em modo JSON, chamadas de ferramentas e casos de recusa/erro.
- Verifique streaming e contabilização de uso. Confira se o uso final aparece onde seu código de billing ou observabilidade espera, especialmente para respostas em streaming.
- Verifique custo e quotas. Confirme a precificação do provider ou a precificação da Flatkey e depois defina uma quota baixa ou um orçamento de teste antes de aumentar o tráfego em produção.
- Registre o novo ID do modelo. Garanta que traces, alertas e exports de billing mostrem
deepseek-v4-flashoudeepseek-v4-pro, e não apenas um rótulo genérico de provider. - Prepare o rollback. Mantenha um provider anterior ou um modelo de fallback configurado até que a rota V4 tenha passado por testes com workload real.
- Remova docs obsoletos. Atualize os guias internos de setup para que novos desenvolvedores não copiem aliases descontinuados de volta para produção.
Modelo de Configuração Para Flatkey
Apenas modelo: execute isto com uma chave Flatkey válida e um ID de modelo Flatkey DeepSeek V4 confirmado do catálogo atual. A estrutura é o uso normal do SDK da OpenAI, mas a rota, o status do modelo, o comportamento de pensamento e o log de uso ainda precisam ser testados.
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-v4-flash"
# Mantenha o destino fácil de alterar durante a implantação.
# Para comparação direta com DeepSeek:
DEEPSEEK_BASE_URL="https://api.deepseek.com"import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ.get("FLATKEY_DEEPSEEK_MODEL", "deepseek-v4-flash"),
messages=[
{
"role": "user",
"content": "Responda com uma frase confirmando que a rota DeepSeek V4 está configurada.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)Para testes diretos com DeepSeek, siga os exemplos oficiais do SDK da OpenAI do DeepSeek para o modo de pensamento. O guia de pensamento diz que a opção de ativação do pensamento vem habilitada por padrão, o parâmetro de esforço no formato OpenAI suporta high e max, e os rótulos de esforço mais baixos são mapeados para cima por compatibilidade. Se o seu app depende de respostas sem pensamento, torne essa escolha explícita e teste-a em vez de depender de um alias.
Matriz de Testes Antes do Cutover
Uma migração para o DeepSeek V4 só deve ser aceita depois que você testar o comportamento que seu produto realmente usa.
| Teste | O Que Verificar | Sinal de Aprovação |
|---|---|---|
| Chat básico | Prompt simples, formato da resposta, comportamento do parser | O app recebe o conteúdo esperado sem erros de schema ou de função |
| Modo de raciocínio | thinking, reasoning_effort e reasoning_content |
A saída de raciocínio é tratada ou suprimida intencionalmente de acordo com a política do seu produto |
| Streaming | Formato dos chunks, uso final, comportamento de timeout | O parser do cliente e os hooks de faturamento continuam funcionando |
| Chamadas de ferramenta | Schema da ferramenta, argumentos, turns de agente em várias etapas | As chamadas de ferramenta são geradas e consumidas sem JSON malformado ou IDs ausentes |
| Saída estruturada | Prompts em modo JSON e validação | A taxa de aprovação do validador permanece dentro do seu limite de lançamento |
| Contexto longo | Prompts grandes, truncamento, suposições de cache | O tratamento de contexto é previsível e o custo é aceitável |
| Observabilidade do Flatkey | Status da rota, ID do modelo, uso de tokens, custo e logs de erro | As entradas do dashboard correspondem à requisição que você enviou |
| Rollback | Provedor anterior ou modelo de fallback | O tráfego pode voltar por configuração sem um deploy |
Erros Comuns
- Tratar a migração para DeepSeek V4 como uma substituição global de localizar e substituir sem avaliação da saída.
- Substituir
deepseek-reasoner, mas esquecer de testarreasoning_contentem conversas com múltiplas interações. - Deixar aliases em jobs de avaliação, exemplos de suporte ou regras de fallback enquanto o código de produção usa IDs V4.
- Assumir que o comportamento direto do DeepSeek e o comportamento roteado do Flatkey são idênticos sem verificar o status da rota e os logs de uso.
- Copiar um ID de modelo de um artigo antigo em vez da página atual de preços do Flatkey ou do painel.
- Ignorar verificações de custo porque o primeiro teste rápido retorna uma resposta normal.
- Aguardar até 24 de julho de 2026 e então descobrir que um job agendado ou worker em segundo plano ainda usa um alias inacessível.
Como isto se encaixa com outros guias de migração da Flatkey
Se você ainda não centralizou a configuração do provedor, comece com o guia mais amplo de migração da API compatível com OpenAI. Ele cobre mudanças na URL base, testes rápidos e padrões de reversão que se aplicam além do DeepSeek.
Se você ainda está decidindo se deve rotear o DeepSeek diretamente ou por meio de um gateway, compare esta página com o guia existente de acesso à API do DeepSeek. Para orçamento e verificações de linhas de modelo, use o fluxo de trabalho de comparação de preços de modelos de IA e a página atual de preços da Flatkey.
Perguntas frequentes
Quando deepseek-chat e deepseek-reasoner serão descontinuados?
A documentação oficial da DeepSeek lista 24 de julho de 2026 às 15:59 UTC como o horário de desativação, após o qual deepseek-chat e deepseek-reasoner ficarão inacessíveis. Planeje sua migração para o DeepSeek V4 antes dessa data.
O que deve substituir deepseek-chat?
Para o comportamento mais próximo, teste deepseek-v4-flash com comportamento sem raciocínio. A DeepSeek diz que deepseek-chat atualmente direciona para o modo sem raciocínio de deepseek-v4-flash.
O que deve substituir deepseek-reasoner?
Teste deepseek-v4-flash ou deepseek-v4-pro com raciocínio habilitado, dependendo das suas necessidades de qualidade, custo e latência. A DeepSeek diz que deepseek-reasoner atualmente direciona para o modo de raciocínio de deepseek-v4-flash.
Preciso alterar a URL base da DeepSeek?
Para chamadas diretas da DeepSeek no formato OpenAI, a URL base oficial continua sendo https://api.deepseek.com. Para chamadas Flatkey, use https://router.flatkey.ai/v1 e uma chave de API da Flatkey.
A Flatkey oferece suporte ao DeepSeek V4?
O instantâneo da API de preços da Flatkey de 16 de junho de 2026 listava deepseek-v4-pro e deepseek-v4-flash com suporte ao endpoint openai. O mesmo instantâneo mostrava o status de disponibilidade unknown_failure para essas linhas, então verifique a página de preços atual, o status da rota no painel e um teste rápido em ambiente real antes do tráfego de produção.
Devo escolher deepseek-v4-flash ou deepseek-v4-pro?
Use deepseek-v4-flash como o primeiro candidato de substituição para compatibilidade com aliases antigos. Teste deepseek-v4-pro quando a carga de trabalho precisar de raciocínio mais forte ou capacidade de agente, e seus critérios de latência e custo forem atendidos.
Veja os preços antes de mudar o tráfego de produção
A migração para o DeepSeek V4 é o momento certo para remover aliases descontinuados, tornar explícito o comportamento de raciocínio e colocar a seleção do modelo atrás da configuração. Antes da implantação, confirme a linha atual do modelo Flatkey, o status da rota, os logs de uso e os preços para deepseek-v4-flash ou deepseek-v4-pro.
Veja os preços para verificar as linhas atuais do Flatkey DeepSeek V4 antes de mover o tráfego de produção.
