PT ▾
Obter chave de API

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.

Atualizado

Dois conectores correspondentes unidos por blocos de código brilhantes, mostrando uma substituição de API pronta para usar
Duas pilhas de moedas de alturas diferentes alimentando um pequeno servidor, mostrando o preço de tokens de entrada e saída

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.

PerguntaDocumentos da DeepSeekEsta API
URL baseDocumentado em seu início rápido (api.deepseek.com)https://api.deepseek4api.com/v1
AutenticaçãoToken Bearer no cabeçalho AuthorizationToken Bearer no cabeçalho Authorization
Nome do modeloListado em seus documentos de modelo; verifique os nomes atuaisuncensored
Endpoint principalCompletions de chatChat completions, Responses, lista de modelos
PreçosVerifique 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_limited ou concurrency.
  • Saldo. Verifique o crédito com GET /v1/balance, a rota de concessões de crédito estilo OpenAI, ou o cabeçalho X-Balance-USD em 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Monitore o custo. Registre o usage de cada resposta e compare-o com o cabeçalho X-Balance-USD ao longo de um dia de tráfego.
  6. 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.

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.