Chave de API DeepSeek no VS Code: configuração com nossa API

O resumo

Você perguntou como usar a chave de API deepseek no vscode, e a resposta tem duas partes. Primeiro, o próprio VS Code não aceita uma chave de API para um modelo de linguagem; isso é feito por uma extensão. Segundo, a chave deste site não é uma chave DeepSeek. Ela pertence a uma API independente e compatível com OpenAI que executa um modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso legal por adultos, e não é a API oficial da DeepSeek. Se você possui uma chave da própria plataforma da DeepSeek, insira-a com o endpoint da DeepSeek.

Para esta API, cada extensão precisa dos mesmos três valores:

• URL base: https://api.deepseekapikey.com/v1
• Chave de API: a chave da sua conta, enviada como token Bearer
• Modelo: uncensored

As seções abaixo mostram onde esses valores vão no Continue e em extensões da família Cline, depois como verificar se tudo funciona e manter os custos previsíveis.

Antes de começar: obtenha uma chave e teste-a

Cadastre-se na página de chaves de API com Google ou com e-mail e senha. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique, válido por 7 dias, um por pessoa, sem necessidade de cartão. Recargas pagas começam em $20.

Abra o terminal integrado no VS Code (Ctrl+` ou Cmd+`) e execute uma requisição. Se isso funcionar, qualquer falha posterior é uma configuração da extensão, não um problema com a chave.

Copyexport API_KEY="paste-your-key-here"

curl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}],
    "max_tokens": 200
  }'

Uma resposta JSON com uma matriz choices significa que a chave, a URL e o nome do modelo estão corretos. Um 401 indica uma chave inválida. Um 404 geralmente indica um caminho errado. Você também pode acessar GET /v1/models com o mesmo cabeçalho como uma verificação econômica.

Opção 1: a extensão Continue

Continue é uma extensão de assistente de código aberto para VS Code que permite definir seus próprios modelos. Instale-a na visualização Extensões, abra suas configurações e adicione um modelo que use o provedor OpenAI com uma URL base personalizada. O Continue mudou seu formato de configuração ao longo do tempo, de um arquivo JSON para um arquivo YAML, então verifique a documentação atual da extensão se o seu arquivo parecer diferente. Os campos têm o mesmo significado em ambos. Na forma JSON, uma entrada de modelo se parece com isto:

Copy{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.deepseekapikey.com/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

Na forma YAML, a entrada do modelo tem as mesmas chaves: um nome, provider: openai, model: uncensored, apiBase definido para a URL base, e a chave. Salve o arquivo, selecione o novo modelo no menu suspenso de modelos do Continue e faça uma pergunta no painel lateral.

Observe que esta API documenta apenas completions de chat. Chat, edição e explicação são o uso natural. O autocompletar com Tab inline geralmente depende de um estilo de requisição diferente destinado a completar texto no meio de uma linha, o que não está listado entre os recursos desta API, então não espere que funcione. Mantenha um provedor de autocompletar separado para isso se precisar de um.

A chave fica em um arquivo, então mantenha esse arquivo fora do seu repositório. Se você usar uma configuração em nível de workspace, adicione-a ao .gitignore, ou use a configuração global no seu diretório home.

Opção 2: Cline e extensões de agente semelhantes

Cline, e extensões derivadas dele como Roo Code, executam um agente que lê arquivos, propõe edições e executa comandos com sua aprovação. O painel de configurações tem um menu suspenso de provedor de API. Escolha a entrada para um provedor compatível com OpenAI e preencha o formulário:

1. URL base: https://api.deepseekapikey.com/v1
2. Chave de API: sua chave
3. ID do Modelo: uncensored

Algumas versões solicitam o tamanho da janela de contexto e um valor máximo de saída para o modelo personalizado. Insira 100000 para a janela, pois esse é o tamanho do contexto desta API, prompt e resposta juntos. Escolha uma saída máxima de alguns milhares de tokens para que uma resposta não saia do controle.

Agentes usam chamada de funções ou um formato de texto estruturado para agir, e a API suporta o formato de chamada de funções OpenAI (resultados tools, tool_choice, role: "tool") junto com streaming. O quão bem qualquer modelo segue as instruções de um agente varia, então comece com tarefas pequenas, como renomear uma função em dois arquivos, e observe os primeiros passos antes de deixá-lo executar por mais tempo.

Agentes também enviam muitas requisições em sequência. Uma chave completa permite 8 requisições simultâneas e 300 por minuto, uma chave de teste 2 e 60. Um único agente geralmente fica bem dentro desses números, mas dois agentes mais um painel de chat em uma chave de teste podem atingir o limite de concorrência e produzir erros 429.

Chamando a API do seu próprio código no VS Code

Às vezes, o objetivo não é uma extensão, mas um script que você executa a partir do editor. Qualquer SDK OpenAI funciona. Em Node:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseekapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Review this function for off-by-one errors." }],
});
console.log(res.choices[0].message.content);

Mantenha a chave em uma variável de ambiente, um arquivo .env que é ignorado pelo git, ou no armazenamento de segredos do seu sistema operacional, nunca em um arquivo comitado. A versão Python da mesma chamada usa OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key=...). O quickstart tem mais exemplos, incluindo streaming e modo JSON.

Quanto custam as sessões de código

O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Assistentes de código enviam muito contexto, então a entrada domina. Pegue uma requisição com 30.000 tokens de código e histórico de chat e uma resposta de 1.000 tokens:

• Entrada: 30.000 / 1.000.000 x $0,15 = $0,0045
• Saída: 1.000 / 1.000.000 x $0,50 = $0,0005
• Total: $0,005 por requisição, então 200 requisições custam $1,00.

Um prompt completo de 100.000 tokens com a mesma resposta custa $0,015 + $0,0005 = $0,0155. Isso ainda é pouco, mas loops de agente repetem isso muitas vezes, então mantenha o contexto apertado: abra os arquivos que importam, não o repositório inteiro, e inicie um novo chat quando a tarefa mudar.

O crédito é pré-pago e nunca expira, e não há assinatura. Requisições falhas ou recusadas não são cobradas. Recarregue com qualquer valor inteiro de $20 a $500, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200, pagando com cripto (USDT na TRC20, USDC na Base). Uma recarga de $50 credita $52,50. Veja a página de preços para os detalhes.

Lista de verificação de solução de problemas

• 401 Não autorizado. A chave está errada ou tem espaços em branco à direita. Lembre-se de que uma chave emitida pela própria plataforma da DeepSeek não funcionará aqui.
• 404 Não encontrado. Verifique a URL base. Algumas extensões adicionam /chat/completions automaticamente, então forneça a elas a base terminando em /v1. Outras querem o caminho completo. Siga a dica no campo.
• Modelo não encontrado. O ID do modelo deve ser exatamente uncensored.
• 429 com código concurrency. Muitas requisições de uma vez. Feche chats ou agentes extras. Requisições em streaming mantêm sua posição até o fim.
• 429 com Retry-After: 5. Sobrecarga temporária. Aguarde cinco segundos e a nova tentativa da extensão geralmente tem sucesso.
• Requisição muito grande. O limite do corpo da requisição é 8 MB, e o limite de contexto é 100.000 tokens. Reduza os arquivos anexados.

Prompts não são usados para treinamento, mas sua extensão pode manter seus próprios logs e telemetria, então verifique suas configurações se trabalhar com código privado. O serviço é para uso legal por adultos e tem uma regra rígida contra conteúdo sexual envolvendo menores de idade. Ele gera apenas texto, então código está ok e imagens não. Se você quiser o contexto sobre como este serviço difere da própria DeepSeek, o artigo em mitos e fatos cobre isso.

Mais guias

• Chave de API DeepSeek no Janitor AI: configuração com nossa API
• Chave da API DeepSeek no SillyTavern: Conecte nossa API
• API DeepSeek: Mitos vs. Fatos para Acesso Sem Censura