deepseek4api.comGuia
Guia da API DeepSeek e substituição pronta para usar
A maioria das pessoas que abre os documentos da API deepseek quer as mesmas cinco respostas: a URL base, como autenticar, qual nome de modelo usar, quais parâmetros funcionam e como é uma chamada funcional. Esta página cobre isso e mostra as mesmas chamadas contra um endpoint alternativo compatível com OpenAI que você pode substituir.


Pontos principais
- A DeepSeek documenta uma API estilo OpenAI, então o SDK da OpenAI funciona alterando a URL base, a chave e o nome do modelo.
- Este site não é a API oficial da DeepSeek; serve um único modelo de pesos abertos independente sob o ID uncensored.
- O mesmo código funciona em ambos: apenas três valores mudam.
- A janela de contexto aqui é de 100.000 tokens, com streaming, ferramentas e modo JSON suportados.
As cinco coisas que os documentos da API DeepSeek respondem
Quando desenvolvedores pesquisam pelos documentos da API deepseek, normalmente estão tentando completar uma primeira requisição. O padrão é o mesmo para qualquer serviço estilo OpenAI, o que torna uma tabela fácil para comparar.
| Pergunta | Documentos da DeepSeek | Esta API |
|---|---|---|
| URL base | Documentado em seu início rápido (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| Autenticação | Token Bearer no cabeçalho Authorization | Token Bearer no cabeçalho Authorization |
| Nome do modelo | Listado em seus documentos de modelo; verifique os nomes atuais | uncensored |
| Endpoint principal | Completions de chat | Chat completions, Responses, lista de modelos |
| Preços | Verifique os preços atuais deles | $0,15 / 1M tokens de entrada, $0,50 / 1M tokens de saída |
Leia as próprias páginas da DeepSeek para qualquer informação sobre seus modelos, preços e limites; eles mudam, e este artigo não tenta repeti-los. O ponto é que o formato da requisição é compartilhado, então mudar entre os dois é apenas uma alteração de configuração.
Uma coisa a deixar claro: este site não é a API oficial da DeepSeek, e não é um roteador para a DeepSeek. É um endpoint hospedado, compatível com OpenAI, que serve um único modelo de pesos abertos operado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal.
Passo 1: autenticação e URL base
Crie uma conta (Google, ou e-mail e senha) e abra a página da chave de API. Copie a chave. Novos usuários também podem reivindicar $0,50 de crédito de teste com um clique, válido por 7 dias e sem necessidade de cartão.
Cada requisição carrega o cabeçalho Authorization: Bearer YOUR_KEY. Com curl:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Isso lista o modelo disponível, uncensored. Se você copiar um exemplo da DeepSeek, substitua três coisas: a URL base, a chave e o nome do modelo. Nada mais precisa mudar.
Passo 2: uma chat completion em Python
O SDK da OpenAI é o que os documentos da DeepSeek usam em seus exemplos, e funciona inalterado aqui:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
Os parâmetros de amostragem suportados, incluindo temperature, top_p, stop, seed e as penalidades de presença e frequência, são passados diretamente. max_tokens é opcional porque a completion pode usar qualquer coisa que reste da janela de 100.000 tokens.
Passo 3: streaming, modo JSON e ferramentas
Streaming
Defina stream: true para receber eventos enviados pelo servidor. O uso é relatado no final do stream.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
Modo JSON
Passe response_format: {"type": "json_object"} e mencione JSON no seu prompt. A saída é um objeto JSON que você pode analisar diretamente.
Chamada de funções
Os parâmetros tools e tool_choice funcionam no formato OpenAI, as chamadas de ferramentas retornam em deltas, e você retorna resultados como mensagens com role: "tool". Se seu código já faz chamada de funções contra a DeepSeek, deve portar com a alteração de três valores acima, mas teste seus próprios esquemas.
Onde as duas APIs diferem
O mesmo protocolo não significa o mesmo serviço. Coisas a verificar ao mover uma carga de trabalho:
- Comportamento do modelo. Um modelo diferente dá respostas diferentes, estilo de raciocínio e comportamento de recusa. Reexecute seu conjunto de prompts antes de mudar qualquer coisa em produção.
- Campos específicos de raciocínio. Se você depende de campos de resposta específicos do fornecedor de um modelo DeepSeek específico, não assuma que eles existem aqui. Os campos padrão de chat completion existem.
- Recursos não oferecidos. Esta API é apenas texto: sem imagens, áudio, vídeo, embeddings ou ajuste fino.
- Limites. Uma chave completa permite 8 requisições simultâneas e 300 por minuto; uma chave de teste permite 2 e 60. Ao ultrapassar um limite, você recebe HTTP 429 com
rate_limitedouconcurrency. - Saldo. Verifique o crédito com
GET /v1/balance, a rota de concessões de crédito estilo OpenAI, ou o cabeçalhoX-Balance-USDem cada resposta.
Para ver como um usuário focado na DeepSeek pensa sobre custos, consulte as notas de preço da DeepSeek; para configurações de editor, o guia do VS Code.
Quanto custa uma chamada aqui
A cobrança é pré-paga e por token: $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída. Uma requisição com 1.500 tokens de entrada e 600 tokens de saída custa 1.500 x $0,15 / 1M = $0,000225 para entrada mais 600 x $0,50 / 1M = $0,0003 para saída, um total de $0,000525. Uma recarga de $20 cobre cerca de 38.000 chamadas assim.
Recargas aceitam qualquer valor inteiro de $20 a $500, com +5% de $50, +10% de $100 e +15% de $200. Você pode pagar com cripto (USDT na TRC20, USDC na Base). O crédito nunca expira, e requisições falhas ou recusadas não são cobradas. Detalhes na página de preços.
Uma lista de verificação de migração
Se você está portando um aplicativo que já fala com a DeepSeek, siga estes passos em ordem. Cada etapa leva minutos.
- Coloque os três valores na configuração. URL base, chave e nome do modelo devem vir de variáveis de ambiente, não constantes espalhadas pelo código.
- Execute um teste de fumaça. Uma chat completion, uma completion em streaming, uma chamada em modo JSON e uma chamada de tool. Os quatro trechos acima cobrem eles.
- Replay de prompts reais. Pegue 30 prompts dos seus logs e compare as respostas lado a lado. Julgue-os contra seus próprios critérios, não uma pontuação genérica.
- Lide com 429. Adicione retry com backoff e respeite
Retry-After. Uma requisição em streaming mantém sua vaga de concorrência até que o stream termine, então feche streams abandonados. - Monitore o custo. Registre o
usagede cada resposta e compare-o com o cabeçalhoX-Balance-USDao longo de um dia de tráfego. - Implemente gradualmente. Envie 5 a 10 por cento do tráfego para o novo endpoint primeiro, depois aumente.
Compare o custo por tarefa, não o preço por token, porque modelos diferentes usam números diferentes de tokens para a mesma tarefa. Para uma verificação aberta de como modelos de escrita permissivos se comportam, o relatório de roleplay é um companheiro útil.
Escolhendo entre elas
Use a API própria da DeepSeek quando você precisar especificamente de um modelo DeepSeek, de seus recursos de fornecedor ou de seu suporte oficial. Use este endpoint quando quiser um modelo compatível com OpenAI hospedado que responda sem recusas de conteúdo para uso adulto lícito, com faturamento simples de crédito pré-pago e prompts que não são usados para treinamento. Muitas equipes vão querer ambos atrás de uma chave de configuração, o que o protocolo compartilhado torna fácil. O material de referência para esta API está na documentação.
Mais guias
Perguntas e respostas
Esta é a API oficial da DeepSeek?
Não. É um endpoint independente compatível com OpenAI que serve um único modelo de pesos abertos sob o ID uncensored. Não é o serviço da DeepSeek e não faz roteamento para ela.
Posso reutilizar meu código da DeepSeek?
Se usar o SDK da OpenAI ou o formato de conclusões de chat, geralmente sim. Altere a URL base, a chave e o nome do modelo, depois teste seus prompts.
Onde encontro o nome do modelo?
Chame GET /v1/models. Esta API serve um único modelo com o ID uncensored.
Qual é o tamanho da janela de contexto?
100.000 tokens para prompt mais conclusão.
Token Bearer no cabeçalho Authorization
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.