Guia de Integração: chave de API deepseek coder

URL Base e Autenticação

Sua chave de API autentica cada solicitação. Defina a URL base para https://api.deepseekcoderapikey.com/v1 na configuração do seu cliente. Esta URL lida com os endpoints de conclusões de chat e modelos sem exigir segmentos de caminho extras. Você recebe uma única chave por conta, e gerar uma nova substitui a chave anterior imediatamente.

Armazene a chave em uma variável de ambiente chamada DEEPSEEK_API_KEY ou passe diretamente para o seu cliente SDK. O endpoint aceita cabeçalhos padrão, então você pode trocar de provedores alterando apenas o URL base e o valor da chave. Esta abordagem funciona com Cursor, extensões VS Code e ferramentas de desenvolvimento local que esperam uma interface compatível com OpenAI.

A autenticação falha com um status 401 se a chave estiver ausente ou inválida. Use o

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

exemplo para verificar a conectividade antes de integrar na lógica do seu aplicativo.

Endpoint Chat Completions (POST)

Envie mensagens para o POST /v1/chat/completions endpoint usando o ID do modelo uncensored. Esse endpoint processa entrada de texto e retorna saída de texto, suportando respostas síncronas e em streaming. Você pode configurar o comportamento do modelo usando parâmetros como temperatura, top_p e sequências de parada.

A janela de contexto permite até 100.000 tokens para o prompt e combinação combinados. Se você não especificar um limite max_tokens, o modelo usa como padrão 2.048 tokens por solicitação. Use o

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

snippet para ver como estruturar uma solicitação de chat padrão com o SDK Python oficial da OpenAI.

Erros como crédito insuficiente retornam um código de status 402, enquanto solicitações malformadas retornam 400. Verifique o corpo da resposta para mensagens de erro detalhadas e depure a estrutura do seu payload rapidamente.

Endpoint Models (GET)

Consulte os modelos disponíveis enviando um GET /v1/models solicitação. Este endpoint retorna uma lista de objetos de modelo, incluindo o uncensored ID do modelo. Você pode usar este endpoint para verificar se sua chave de API é válida e se o serviço está online antes de fazer solicitações de uso intensivo.

A resposta inclui metadados como o ID do modelo, o tipo de objeto e as informações de propriedade. Use esses dados para configurar dinamicamente seu aplicativo ou para registrar os modelos disponíveis para fins de depuração. O endpoint não requer um corpo, apenas o cabeçalho de autenticação padrão.

Integrar essa verificação na sequência de inicialização do seu sistema garante que seu aplicativo falhe rapidamente se a API estiver inacessível. Isso também ajuda a verificar se a URL base está configurada corretamente antes de prosseguir com as chamadas reais de conclusão de chat.

Respostas em Streaming (SSE)

Habilite o streaming definindo o stream parâmetro para true na sua solicitação. A API retorna um fluxo de Server-Sent Events (SSE), entregando tokens conforme são gerados. Essa abordagem reduz a latência percebida para assistentes de código e permite atualizações de interface em tempo real no seu aplicativo.

Cada chunk contém conteúdo parcial, e o último chunk inclui as estatísticas completas de uso de tokens. Analise o fluxo SSE cuidadosamente para lidar com interrupções de rede e armazenar em buffer tokens parciais. O

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

exemplo demonstra como lidar com o stream em JavaScript.

O streaming é ideal para geração de código de longo formato ou explicações detalhadas. Ele proporciona uma experiência de usuário mais suave em comparação com a espera pela resposta completa. Certifique-se de que seu cliente lide corretamente com o evento de fim do stream para finalizar a resposta.

Chamada de Função e Modo JSON

Use chamadas de função para permitir que o modelo invoque ferramentas externas. Defina suas funções no tools parameter e especifique o tool_choice para controlar quando o modelo utiliza ferramentas. A API suporta definições padrão de ferramentas, permitindo-lhe integrar com os seus próprios serviços de backend.

Para saídas estruturadas, ative o modo JSON definindo response_format para json_object. Isso força o modelo a retornar JSON válido, o que é útil para analisar dados de configuração ou respostas de API. O

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

snippet mostra como configurar o modo JSON no Node.js.

Combine chamada de funções com streaming para uso interativo de ferramentas. O modelo pode invocar várias ferramentas em uma única rodada, permitindo fluxos de trabalho complexos em múltiplas etapas. Certifique-se de que seu cliente lide corretamente com a saída das ferramentas para manter o contexto da conversa.

Limites de Taxa e Restrições

Sua chave de API está limitada a 300 requisições por minuto e 8 requisições simultâneas. O tamanho máximo do corpo da requisição é de 8 MB. Se você exceder esses limites, a API retornará um erro 429 Too Many Requests. Implemente backoff exponencial no seu cliente para lidar com os limites de taxa de forma graciosa.

Erros como 401 indicam uma chave inválida, enquanto 402 sinaliza crédito pré-pago insuficiente. Reembolsos não são emitidos para crédito, mas cobranças duplicadas podem ser resolvidas via página de Suporte. O crédito nunca expira, então você pode recarregar quando for conveniente.

A janela de contexto de 100.000 tokens aplica-se ao prompt e à conclusão totais. Monitore o uso de tokens para permanecer dentro do orçamento. Use o sistema de crédito pré-pago para pagar apenas pelo que usar, sem mensalidades ou assinaturas.