Se você precisa de acesso à API da DeepSeek dentro de um produto que já usa SDKs no estilo OpenAI, o caminho de migração mais limpo geralmente não é uma reescrita completa do cliente. É uma decisão sobre URL base, chave de API e ID do modelo.
A documentação oficial da API da DeepSeek diz que a API usa formatos compatíveis com OpenAI e Anthropic. Em 11 de junho de 2026, os nomes atuais dos modelos DeepSeek no quickstart oficial são deepseek-v4-flash e deepseek-v4-pro. Os aliases mais antigos deepseek-chat e deepseek-reasoner ainda estão documentados, mas a DeepSeek marca ambos para descontinuação em 24 de julho de 2026 às 15:59 UTC.
Esse detalhe do nome do modelo importa. Muitos guias de acesso à API da DeepSeek ainda mostram aliases antigos ou se concentram apenas em uma chave direta do provedor. Este guia mostra como avaliar o acesso direto à DeepSeek e como adicionar a DeepSeek por meio de um roteador compatível com OpenAI, como a Flatkey, onde o mesmo padrão de aplicação pode ficar ao lado de GPT, Claude, Gemini, Qwen, Seedance e modelos de imagem.
Resposta rápida: acesso direto à API da DeepSeek vs acesso por roteador
O melhor caminho de acesso à API da DeepSeek depende do que você quer controlar.
| Caminho de acesso | Use-o quando | O que muda no código | O que verificar |
|---|---|---|---|
| API direta da DeepSeek | Você quer uma conta direta na DeepSeek, preços diretos da DeepSeek e a documentação nativa da DeepSeek como fonte de verdade. | Defina a base URL do SDK da OpenAI como https://api.deepseek.com e use uma chave de API da DeepSeek. |
Nomes atuais dos modelos, notas de descontinuação, preços, limites de tokens e limites de taxa na documentação da DeepSeek. |
| Roteador Flatkey compatível com OpenAI | Você quer a DeepSeek junto com outras famílias de modelos por meio de uma única chave de API, cobrança unificada e um painel para chaves, uso e roteamento. | Defina a base URL como https://router.flatkey.ai/v1, use uma chave da Flatkey e escolha um ID de modelo DeepSeek listado pela Flatkey. |
Disponibilidade no catálogo de modelos da Flatkey, grafia do ID do modelo, página de preços e logs de uso após a primeira chamada. |
| Proxy auto-hospedado | Você precisa operar seu próprio gateway, camada de políticas ou infraestrutura privada de roteamento. | Seu app aponta para o endpoint do seu proxy, e a sua equipe de plataforma conecta esse proxy às contas dos provedores. | Implantação, segredos, observabilidade, resposta a incidentes e propriedade da conta do provedor. |
Se a sua equipe precisa apenas de uma carga de trabalho da DeepSeek e quer um relacionamento comercial direto, a configuração direta com o provedor é simples. Se a sua equipe está adicionando a DeepSeek a uma stack existente de múltiplos modelos, o acesso à API da DeepSeek baseado em roteador pode reduzir a proliferação de contas e manter a migração próxima do padrão de cliente compatível com a OpenAI que você já usa.
Os Fatos Atuais do DeepSeek a Verificar Primeiro
Antes de colocar em produção o acesso à API do DeepSeek, verifique os nomes dos modelos no dia em que você publicar ou implantar. A documentação oficial do DeepSeek mostra atualmente esta base:
| Campo | Detalhe Oficial Atual |
|---|---|
| URL base no formato OpenAI | https://api.deepseek.com |
| URL base no formato Anthropic | https://api.deepseek.com/anthropic |
| IDs atuais dos modelos | deepseek-v4-flash e deepseek-v4-pro |
| Aliases descontinuados | deepseek-chat e deepseek-reasoner estão documentados como descontinuados após 24 de julho de 2026 às 15:59 UTC. |
| Contexto e saída | A página de preços do DeepSeek lista 1M de comprimento de contexto e uma saída máxima de 384K para os modelos V4 atuais. |
| Base de preços | A página de preços do DeepSeek lista preços por 1M de tokens e recomenda verificar a página para obter os preços atuais. |
É por isso que um guia moderno de acesso à API do DeepSeek não deve fixar deepseek-chat como modelo padrão. Se você usar esse alias hoje, crie um plano de migração para deepseek-v4-flash ou deepseek-v4-pro. Se você usar um roteador, verifique se o catálogo do roteador expõe os IDs atuais dos modelos do DeepSeek, os aliases de compatibilidade mais antigos, ou ambos.
Acesso Direto à API DeepSeek Com o SDK da OpenAI
Para acesso direto à API DeepSeek, a configuração parece familiar se seu app já usa o SDK da OpenAI. Você cria um cliente, altera a URL base, usa uma chave de API da DeepSeek e chama um modelo da DeepSeek.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro",
messages: [
{ role: "system", content: "You are a concise technical assistant." },
{ role: "user", content: "Summarize this migration plan." }
],
stream: false
});
console.log(response.choices[0].message.content);Use este caminho quando a própria conta DeepSeek fizer parte do requisito. O acesso direto à API DeepSeek mantém a documentação, os preços, os limites de taxa e o suporte da DeepSeek como o principal modelo operacional.
A configuração direta também oferece a menor ambiguidade em torno dos parâmetros específicos da DeepSeek. Os exemplos atuais da DeepSeek incluem campos relacionados a thinking para modelos V4. Se esses parâmetros forem importantes para sua carga de trabalho, teste-os diretamente na DeepSeek primeiro e depois confirme se seu roteador passa os mesmos campos antes de usá-los em produção por meio de um gateway.
Acesso à API da DeepSeek via Flatkey
Flatkey é útil quando o acesso à API da DeepSeek é um requisito de uma família de modelos dentro de uma stack mais ampla. O texto público do produto da Flatkey diz que os desenvolvedores podem acessar Claude, GPT, Gemini, DeepSeek, Qwen, Seedance 2.0, GPT Image e mais com uma única chave de API, sem gerenciar contas separadas de provedores. Ele também descreve preços claros, cobrança unificada, um único painel para chaves, uso e roteamento, além de troca automática e balanceamento de carga.
O padrão de migração do roteador é intencionalmente pequeno:
- Crie ou use uma chave de API da Flatkey.
- Aponte seu cliente compatível com OpenAI para
https://router.flatkey.ai/v1. - Selecione um ID de modelo DeepSeek mostrado na sua página de preços ou no painel da Flatkey.
- Execute uma solicitação não crítica.
- Confirme a resposta, a rota do modelo, o registro de uso e a linha de custo no painel.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro", // Confirme o ID de modelo atual da Flatkey antes da implantação.
messages: [
{ role: "system", content: "Você é um assistente técnico conciso." },
{ role: "user", content: "Redija uma nota de lançamento para este recurso." }
]
});
console.log(response.choices[0].message.content);Em 11 de junho de 2026, o endpoint público de preços da Flatkey retornou 653 linhas de modelos e incluiu linhas da DeepSeek como deepseek-v4-flash, deepseek-v4-pro, deepseek-v3.2, deepseek-v3.2-thinking, deepseek-chat e deepseek-reasoner. Trate isso como uma captura de catálogo datada, não como uma garantia permanente. Para acesso à API da DeepSeek em produção, verifique a página de preços ao vivo da Flatkey e o seletor de modelos da sua conta antes de escolher um ID de modelo.
Quando um roteador ajuda mais do que uma chave direta
Um roteador não é automaticamente melhor do que o acesso direto à API do DeepSeek. Ele é melhor quando a camada de acesso ao redor é a parte difícil.
O acesso à API do DeepSeek baseado em roteador é uma boa opção quando:
- Seu aplicativo já chama conclusões de chat compatíveis com a OpenAI.
- Você quer adicionar o DeepSeek sem adicionar outro fluxo de trabalho de conta de provedor para cada desenvolvedor.
- Você está comparando o DeepSeek com GPT, Claude, Gemini ou Qwen no mesmo recurso do produto.
- Você precisa de uma única superfície para revisão de faturamento e uso para uma equipe.
- Você quer criar hábitos de cota antes que o tráfego cresça.
- Você quer um caminho de migração mais limpo se o nome de um modelo, a regra de um provedor ou o preço mudar.
O acesso direto à API do DeepSeek é uma opção melhor quando:
- Você precisa de um contrato direto com o DeepSeek ou de um relacionamento com o provedor.
- Você está testando parâmetros de requisição específicos do DeepSeek que talvez ainda não sejam passados pelo roteador.
- Suas políticas de compras ou de dados exigem termos diretos do provedor.
- Você quer isolar uma carga de trabalho somente do DeepSeek, sem necessidade de roteamento multimódelo.
Lista de verificação de migração para apps existentes compatíveis com OpenAI
Use esta lista de verificação antes de mover o acesso à API DeepSeek para um caminho de produção.
| Etapa | O que fazer | Por que isso importa |
|---|---|---|
| 1 | Liste a carga de trabalho exata: chat, raciocínio, saída JSON, chamadas de ferramentas ou assistência de código. | A escolha do modelo DeepSeek V4 e o modo de raciocínio devem corresponder à carga de trabalho. |
| 2 | Escolha um ID de modelo atual, de preferência deepseek-v4-flash ou deepseek-v4-pro quando disponíveis. |
Aliases mais antigos têm um aviso de descontinuação datado na documentação oficial da DeepSeek. |
| 3 | Altere a URL base e a chave de API em um ambiente de não produção. | Isso confirma que a migração é realmente uma mudança de configuração, não uma reescrita. |
| 4 | Envie um pequeno prompt de teste e inspecione a forma da resposta, o uso de tokens e os erros. | Ser compatível com OpenAI não elimina a necessidade de validar o comportamento do modelo. |
| 5 | Verifique faturamento e registros de uso na DeepSeek ou na Flatkey, dependendo do caminho de acesso. | A visibilidade de custos faz parte da decisão de acesso, não é algo secundário. |
| 6 | Teste o comportamento de fallback para um erro upstream, timeout ou condição de cota. | Usuários de roteador precisam saber o que acontece quando uma rota de modelo falha. |
| 7 | Fixe IDs de modelo na configuração e agende uma revisão dos nomes dos modelos antes de 24 de julho de 2026. | Isso evita depender de aliases descontinuados após a data anunciada pela DeepSeek. |
Sobre o Acesso Gratuito à API DeepSeek
Algumas pesquisas sobre este tema usam termos como chave de API DeepSeek com acesso gratuito, acesso gratuito à API DeepSeek R1 ou limites de acesso gratuito à API DeepSeek. Não crie um plano de produção com base nessas expressões, a menos que a página do provedor ou do roteador atual documente explicitamente a oferta.
A página oficial de preços da DeepSeek é a fonte correta para os preços diretos do provedor. A página de preços da Flatkey é a fonte correta para o uso roteado pela Flatkey. Este artigo não afirma um limite de acesso gratuito à API DeepSeek, porque as permissões gratuitas podem mudar rapidamente e devem ser verificadas na fonte no dia em que você se inscrever.
Configuração Recomendadа
Para a maioria das equipes de produto que estão adicionando o DeepSeek a um app existente compatível com OpenAI, comece com um pequeno teste de roteador:
- Abra a página de preços da Flatkey e confirme os IDs atuais dos modelos DeepSeek.
- Crie uma chave Flatkey e defina
baseURLcomohttps://router.flatkey.ai/v1. - Execute uma solicitação de baixo risco com apenas
deepseek-v4-flashoudeepseek-v4-prose o modelo estiver listado para a sua conta. - Verifique o registro de uso e faturamento.
- Compare a mesma carga de trabalho com GPT, Claude, Gemini ou Qwen se o seu produto precisar de roteamento multmodelo.
Esse caminho mantém o acesso à API do DeepSeek prático. Você ainda respeita os nomes oficiais dos modelos do DeepSeek e as notas de descontinuação, mas avalia o DeepSeek dentro do mesmo fluxo de trabalho de roteamento, faturamento e uso que sua equipe pode usar para o restante da sua pilha de modelos.
Ver preços para verificar o catálogo atual de modelos DeepSeek da Flatkey e comparar o uso roteado antes de migrar o tráfego de produção.
FAQ
Qual é a URL base atual da API da DeepSeek?
Para acesso direto à API da DeepSeek no formato OpenAI, a documentação oficial da DeepSeek lista https://api.deepseek.com. Para acesso no formato Anthropic, a documentação lista https://api.deepseek.com/anthropic. Através da Flatkey, a URL base do roteador compatível com OpenAI é https://router.flatkey.ai/v1.
Qual modelo da DeepSeek devo usar agora?
O guia rápido oficial atual da DeepSeek lista deepseek-v4-flash e deepseek-v4-pro. A documentação informa que deepseek-chat e deepseek-reasoner serão descontinuados em 24 de julho de 2026 às 15:59 UTC, então novos trabalhos de acesso à API da DeepSeek devem evitar tratar esses aliases como padrão de longo prazo.
Posso usar o SDK da OpenAI para a DeepSeek?
Sim. A documentação da DeepSeek afirma que o formato da sua API é compatível com OpenAI e Anthropic. Com o SDK da OpenAI, o acesso direto à DeepSeek usa a URL base e a chave da DeepSeek. Com a Flatkey, o acesso à API da DeepSeek via roteador usa a URL base e a chave da Flatkey.
A Flatkey oferece acesso gratuito à API da DeepSeek?
Este guia não afirma acesso gratuito à API da DeepSeek. Verifique a atual página de preços da Flatkey para uso roteado e a página oficial de preços da DeepSeek para preços diretos do provedor.
Por que usar a Flatkey em vez de uma chave direta da DeepSeek?
Use a Flatkey quando a DeepSeek fizer parte de uma pilha multmodelo e você quiser uma única chave de API, cobrança unificada, visibilidade de uso e um roteador compatível com OpenAI. Use o acesso direto à API da DeepSeek quando precisar de uma conta direta do provedor, um caminho de suporte direto da DeepSeek ou comportamento de requisição específico do provedor.
