O acesso à API do DeepSeek por meio de um roteador compatível com OpenAI é um padrão de configuração prático para indie hackers que querem modelos DeepSeek sem transformar cada escolha de provedor em uma nova integração de SDK.
Você tem dois caminhos claros. O caminho direto do DeepSeek usa uma chave de API do DeepSeek, a URL base compatível com OpenAI do DeepSeek e um nome de modelo do DeepSeek. O caminho via roteador usa a URL base compatível com OpenAI da Flatkey, uma chave de API da Flatkey e o ID do modelo DeepSeek disponível para a sua conta. Ambos podem funcionar. A escolha certa depende de o DeepSeek ser sua única família de modelos ou apenas uma rota dentro de um produto multimodelo.
Este guia mostra como configurar o acesso à API do DeepSeek por meio de um roteador compatível com OpenAI, como manter o caminho direto do provedor depurável e o que verificar antes que o tráfego de produção seja movido.
Resposta rápida: Acesso à API do DeepSeek por meio de um roteador compatível com OpenAI
Para uma aplicação no estilo OpenAI, o acesso à API do DeepSeek tem duas rotas práticas.
| Decisão | API direta do DeepSeek | DeepSeek via Flatkey |
|---|---|---|
| Chave de API | Chave de API do DeepSeek | Chave de API da Flatkey |
| URL base | https://api.deepseek.com |
https://router.flatkey.ai/v1 |
| Opção no formato Anthropic | https://api.deepseek.com/anthropic |
Use a estrutura de API da Flatkey que sua rota oferecer suporte |
| Nomes atuais de modelos do DeepSeek para verificar | deepseek-flash, deepseek-v4-pro |
IDs de modelos DeepSeek acessíveis à conta na Flatkey em /v1/models e no diretório de modelos |
| Melhor adequação | Um protótipo apenas com DeepSeek ou uma integração específica do provedor | Um app multimodelo que quer um único cliente, uma única chave, uma revisão de uso e fallback mais fácil |
| Verificação operacional | Painel do DeepSeek, documentação do provedor, tabela de preços atual | Lista de modelos da Flatkey, logs de uso, página de preços, página de status e manifesto de rollback |
Use a rota direta quando o DeepSeek for o único modelo de que você precisa e o controle no nível do provedor for o mais importante. Use a Flatkey quando o DeepSeek fizer parte de um conjunto com GPT, Claude, Gemini, Qwen, modelos de mídia ou rotas de agente de código por trás do mesmo cliente compatível com OpenAI.
O que o DeepSeek confirma sobre compatibilidade de API
A documentação atual da API do DeepSeek diz que a API do DeepSeek usa um formato de API compatível com OpenAI e Anthropic. A URL base no formato OpenAI é:
https://api.deepseek.com
O DeepSeek também documenta uma URL base no formato Anthropic:
https://api.deepseek.com/anthropic
A mesma documentação lista deepseek-flash e deepseek-v4-pro como opções de modelo. Ela também diz que os nomes mais antigos deepseek-v4-flash e deepseek-v4-flash-vision-exp ainda são aceitos por compatibilidade, mas essas solicitações são atendidas pelo DeepSeek-V4.1-Flash e cobradas pelo preço do Flash. Para código novo, trate os nomes antigos como risco de migração, não como nomes para copiar para um produto novo.
A página de preços da DeepSeek atualmente descreve deepseek-flash como DeepSeek-V4.1-Flash e deepseek-v4-pro como DeepSeek-V4-Pro-0813. Ela também lista uma janela de contexto de 1M e saída máxima de 384K, com saída em JSON, chamadas de ferramentas, API Responses e suporte à API Anthropic exibidos para ambos os modelos. O suporte a visão está listado para o Flash e não para o Pro. Verifique a página de preços ao vivo da DeepSeek antes de publicar preços exatos na sua própria documentação, porque a tabela usa taxas de token de pico e fora de pico.
O que o Flatkey muda
O Flatkey não remove a necessidade de escolher um ID de modelo válido da DeepSeek. Ele muda onde a rota é configurada e onde você verifica o resultado.
A documentação de início rápido e de API de modelos do Flatkey usa esta URL base compatível com OpenAI:
https://router.flatkey.ai/v1
O endpoint /v1/models do Flatkey retorna os IDs de modelo disponíveis para sua conta em um formato compatível com OpenAI. A documentação de uso do Flatkey diz que cada solicitação pode ser revisada com o modelo usado, contagens de tokens de entrada e saída, custo, timestamp, chave de API e status. Isso torna o acesso à API do DeepSeek por meio de um roteador compatível com OpenAI mais fácil de operar quando a DeepSeek é apenas uma entre várias opções de modelo.
O registro de rota na versão com roteador deve ser explícito:
deepseek_route:
provider_access_layer: flatkey
base_url: https://router.flatkey.ai/v1
api_key_source: FLATKEY_API_KEY
candidate_models:
- deepseek-flash
- deepseek-v4-pro
verify_before_launch:
- account_accessible_v1_models
- live_model_directory
- pricing_page_units
- usage_log_readback
- fallback_or_rollback_policy
Não oculte o nome do modelo como uma string no código da aplicação. Coloque-o em um arquivo de configuração ou manifesto de modelo para que uma atualização do modelo DeepSeek seja uma alteração revisável, e não uma implantação de emergência.
Etapa 1: Escolher DeepSeek direto ou um roteador
Comece pela decisão operacional, não pelo SDK.
| Pergunta | DeepSeek direto geralmente é suficiente quando... | Um roteador geralmente é melhor quando... |
|---|---|---|
| Você chama apenas a DeepSeek? | Sim, o produto é somente DeepSeek. | Não, a DeepSeek é apenas uma rota ao lado de outros provedores. |
| Você precisa de controles específicos do provedor? | Sim, sua equipe quer configurações nativas da DeepSeek e revisão de faturamento. | Não, seu aplicativo quer uma camada de acesso compartilhada e logs compartilhados. |
| Usuários ou jobs vão alternar modelos? | Não, um modelo fixo é suficiente. | Sim, as cargas de trabalho podem mudar entre DeepSeek, Qwen, Gemini, Claude, GPT ou outras famílias de modelos. |
| Quem revisa custo e falhas? | Um desenvolvedor pode verificar a conta da DeepSeek. | Você precisa de um livro-razão de uso único para chaves, modelos e ambientes. |
| O que acontece se a rota falhar? | Você pode pausar o recurso ou tentar novamente mais tarde. | Você precisa de controles de fallback, rollback ou lançamento gradual. |
Para a maioria dos indie hackers, a primeira versão pode ser simples. DeepSeek direta está bem para um protótipo de modelo único. O acesso à API do DeepSeek por meio de um roteador compatível com OpenAI fica mais limpo quando o produto compara modelos, executa agentes de codificação, atende clientes com diferentes necessidades de latência ou custo, ou precisa de um único lugar para depurar o uso de tokens.
Etapa 2: Configurar o cliente OpenAI do Flatkey
Se o seu projeto já usa o SDK da OpenAI, a configuração do roteador é basicamente uma mudança de URL base e de chave.
Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url="https://router.flatkey.ai/v1",
)
Node.js:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1",
});
A versão direta do DeepSeek usa a mesma estrutura de cliente no estilo OpenAI, mas aponta para o DeepSeek:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
Mantenha ambas as chaves em variáveis de ambiente ou em armazenamento de segredos. Nunca faça commit de FLATKEY_API_KEY, DEEPSEEK_API_KEY ou de uma substituição de staging no repositório.
Etapa 3: Verifique o ID do modelo antes da primeira requisição
O acesso à API do DeepSeek por meio de um roteador compatível com OpenAI deve começar com a descoberta do modelo, e não com uma string de modelo copiada.
Para a Flatkey, peça ao roteador quais IDs de modelo sua conta pode acessar:
curl https://router.flatkey.ai/v1/models \
-H "Authorization: Bearer $FLATKEY_API_KEY"
Depois, confirme o candidato no diretório de modelos ao vivo e na página de preços da Flatkey. Para o DeepSeek direto, confirme o nome do modelo na documentação e na página de preços do DeepSeek. Até esta verificação da fonte, a documentação do DeepSeek indica ao novo código os modelos deepseek-flash e deepseek-v4-pro, ao mesmo tempo em que alerta que antigos aliases de V4 Flash são nomes de compatibilidade.
Crie um pequeno manifesto:
models:
deepseek_default:
id: deepseek-flash
route: flatkey
base_url: https://router.flatkey.ai/v1
use_for:
- coding_assistant
- structured_extraction
- long_context_review
owner: product_engineering
rollback: previous_production_model
Este é o registro de revisão da rota do DeepSeek. Ele oferece um lugar para registrar o ID do modelo, o proprietário da rota, o caso de uso e o destino de rollback antes que o tráfego de produção dependa da rota. Mantenha-o com sua lista de verificação de lançamento para que o acesso à API do DeepSeek por meio de um roteador compatível com OpenAI permaneça auditável após o lançamento.
Etapa 4: Faça uma primeira Chat Completion
Comece com uma solicitação curta e determinística. Este é um teste de rota, não um benchmark.
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{"role": "system", "content": "Return concise implementation advice."},
{"role": "user", "content": "Explain why base_url configuration matters in one sentence."},
],
temperature=0.2,
max_tokens=120,
)
print(response.choices[0].message.content)
Se a solicitação falhar, verifique nesta ordem:
| Verificação | O que ela detecta |
|---|---|
base_url |
Confusão entre direto e roteador, falta de /v1, caminho incorreto do provedor |
| Variável da chave da API | Variável de ambiente vazia, tipo de chave incorreto, chave de staging em produção |
| ID do modelo | Alias descontinuado, a conta não tem acesso, erro de digitação |
| Formato do endpoint | Incompatibilidade entre Chat Completions, Responses e Anthropic Messages |
| Suporte a recursos | Suposições sobre visão, modo de raciocínio, JSON, ferramentas ou streaming |
| Log de uso | A solicitação nunca chegou ao roteador, falha do provedor, incompatibilidade de tokens/custo |
Essa ordem evita um erro comum de depuração: tratar falhas de configuração como falhas do modelo.
Etapa 5: Teste os Recursos que Seu App Realmente Usa
Compatível com OpenAI não significa que todo provedor, modelo ou caminho do roteador se comporte de forma idêntica. Teste os recursos que importam para a sua carga de trabalho.
| Recurso | Teste rápido | Condição de aprovação |
|---|---|---|
| Chat sem streaming | Um prompt curto | A mensagem utilizável retorna com dados de uso |
| Streaming | Mesmo prompt com streaming ativado | Os chunks chegam na ordem e a UI fecha corretamente |
| Saída em JSON | Tarefa pequena de extração | A saída valida contra seu schema ou caminho de reparo |
| Chamadas de ferramenta | Um schema simples de função | Os campos de tool-call são interpretados sem hacks personalizados |
| Contexto longo | Entrada longa representativa | Latência, custo e qualidade permanecem aceitáveis |
| Visão | Prompt com imagem somente ao usar um modelo com capacidade de visão | A solicitação só é bem-sucedida em uma rota que ofereça suporte a visão |
| Tratamento de erro | ID de modelo inválido em staging | O app registra a falha da rota sem expor chaves |
Após cada teste Flatkey, abra os Logs de Uso. A solicitação deve mostrar o modelo esperado, contagem de tokens, status, timestamp, chave de API, latência e custo. Se nada aparecer, confirme o base URL e a chave que a solicitação realmente usou.
Etapa 6: Normalize o Custo pelo Resultado Aceito
Os preços de token publicados pela DeepSeek podem parecer atraentes, mas o preço por token é apenas uma parte do custo de produção. Compare pelo resultado aceito.
Use esta planilha:
| Métrica | Por que isso importa |
|---|---|
| Tokens de entrada | Prompts de contexto longo podem dominar o custo. |
| Tokens de saída | Tarefas de agente e de programação podem produzir respostas muito mais longas do que tarefas de chat. |
| Comportamento de cache | Entrada com cache hit e cache miss pode ter preços diferentes. |
| Taxa de repetição | Uma rota barata fica cara quando precisa de repetidas tentativas. |
| Taxa de rejeição | JSON inválido, chamadas de ferramenta fracas ou respostas de baixa qualidade devem contar contra a rota. |
| Uso de fallback | O tráfego de fallback precisa ser visível, não tratado como erro de arredondamento. |
| Tempo de correção humana | A limpeza manual faz parte do custo real do produto. |
A fórmula prática:
accepted_output_cost =
(successful_request_cost + retry_cost + fallback_cost + human_repair_cost)
/ accepted_outputs
Use a página de preços ao vivo do DeepSeek para unidades diretas do provedor. Use a página de preços ao vivo do Flatkey e os seus Logs de Uso para encargos do caminho do roteador. Não copie uma linha de preço estática para a documentação do app sem uma data verificada e um responsável pela atualização.
Etapa 7: Adicione uma política de reversão
DeepSeek API Access Through an OpenAI-Compatible Router deve ser reversível antes que os usuários dependam dele.
deepseek_rollout:
environment: production
default_model: deepseek-flash
route: flatkey
start_percentage: 10
increase_when:
- accepted_output_rate >= 0.95
- p95_latency_ms <= 4500
- error_rate <= 0.02
- usage_log_present: true
- accepted_output_cost_within_budget: true
rollback_when:
- error_rate > 0.05
- schema_failures_above_threshold: true
- usage_log_missing: true
- unexpected_cost_spike: true
rollback_action:
set_model: previous_production_model
notify: engineering_owner
Essa política não exige uma equipe de plataforma. Ela exige um responsável pela rota, um manifesto de modelo, um hábito de revisão de uso e um teste de staging antes de aumentar o tráfego.
Onde Isso se Encaixa no Flatkey
O Flatkey é uma boa opção quando o DeepSeek faz parte de um fluxo de trabalho mais amplo de roteamento de modelos:
- Você já usa SDKs compatíveis com OpenAI e quer uma única base URL para várias famílias de modelos.
- Você precisa de chaves ou cotas separadas para desenvolvimento, staging, produção ou agentes de programação.
- Você quer que DeepSeek, Qwen, Gemini, Claude, GPT e outros modelos sejam revisados por meio de um único catálogo de modelos e fluxo de trabalho de uso.
- Você precisa de um caminho de rollback quando um ID de modelo, unidade de preço, recurso ou rota do provedor muda.
Comece com o Flatkey API quickstart, use o guia de migração da alternativa à OpenAI API se você estiver substituindo chamadas diretas ao provedor, e combine esta lista de verificação com as verificações de roteamento de API DeepSeek vs Qwen quando cargas de trabalho sensíveis a custo compararem provedores regionais.
Para decisões de produção, verifique o diretório de modelos do Flatkey ao vivo, a página de preços e a página de status. Para o comportamento dos modelos DeepSeek e os preços diretos do provedor, verifique a documentação da API e a página de preços do DeepSeek no dia em que você fizer o lançamento.
Final Checklist for DeepSeek API Access Through an OpenAI-Compatible Router
Antes de disponibilizar o acesso à API do DeepSeek para os usuários, confirme:
- O ID do modelo está atualizado na documentação do DeepSeek e na lista de modelos acessível à conta da Flatkey.
- Os testes diretos do DeepSeek usam
https://api.deepseek.come uma chave de API do DeepSeek. - Os testes do roteador Flatkey usam
https://router.flatkey.ai/v1e uma chave de API da Flatkey. - Você não está usando
deepseek-v4-flashoudeepseek-v4-flash-vision-expcomo um novo nome de modelo de produção. - Chat, streaming, saída em JSON, chamadas de ferramenta, contexto longo e visão são testados separadamente quando seu aplicativo precisar deles.
- Os Logs de Uso mostram o ID do modelo esperado, status, contagens de tokens, timestamp, latência, chave de API e custo.
- O custo é normalizado pelo output aceito, não apenas pela taxa nominal de tokens.
- Rollback é uma mudança de configuração, não uma reescrita emergencial do código.
- As chaves do provedor são armazenadas em variáveis de ambiente ou em armazenamento de segredos, nunca no código.
Acesso à API do DeepSeek por meio de um roteador compatível com OpenAI é um padrão de integração simples quando a rota é explícita. Use o DeepSeek direto quando você só precisar do DeepSeek. Use a Flatkey quando o DeepSeek fizer parte de um produto multi-modelo que precisa de um cliente, uma URL base, um fluxo de uso e um caminho de rollback limpo.
Frequently Asked Questions
O DeepSeek oferece suporte à API da OpenAI?
A documentação atual do DeepSeek diz que a API do DeepSeek usa um formato de API compatível com OpenAI e Anthropic. A URL base no formato OpenAI é https://api.deepseek.com.
Qual é a URL base da Flatkey para acesso à API do DeepSeek?
Use https://router.flatkey.ai/v1 para a API compatível com OpenAI da Flatkey. Em seguida, escolha um ID de modelo atual do DeepSeek a partir da resposta /v1/models acessível à sua conta e do diretório de modelos ativo da Flatkey.
Posso usar o mesmo SDK da OpenAI para o DeepSeek por meio da Flatkey?
Sim. Configure o SDK da OpenAI com uma chave de API da Flatkey e https://router.flatkey.ai/v1 como URL base. A requisição mantém a estrutura familiar do Chat Completions para modelos compatíveis.
Qual nome de modelo do DeepSeek o novo código deve usar?
Consulte a documentação ativa do DeepSeek antes de publicar. Nesta verificação da fonte, o DeepSeek lista deepseek-flash e deepseek-v4-pro; ele diz que nomes V4 Flash mais antigos são aceitos por compatibilidade, mas são servidos pelo DeepSeek-V4.1-Flash.
Devo publicar os preços exatos do DeepSeek na documentação do meu próprio app?
Somente se você incluir a data da verificação e o responsável pela atualização. A página de preços do DeepSeek usa taxas de tokens de pico e fora de pico, e a disponibilidade de rotas da Flatkey ou as unidades de preço devem ser verificadas nas páginas ativas de preços e modelos da Flatkey.
