PT ▾
Comece agora

Início rápido: Integração da API DeepSeek Coder

Este guia rápido ajuda você a integrar nossa API DeepSeek Coder sem censura com sua base de código existente usando endpoints compatíveis com OpenAI. Você aprenderá como autenticar, enviar solicitações e lidar com respostas em streaming com controle preciso sobre os parâmetros do modelo.

URL Base e Autenticação

Sua chave de API autentica todas as solicitações para o nosso endpoint hospedado. Use a URL base https://api.coderdeepseek.cc/v1 com qualquer SDK ou cliente HTTP da OpenAI. O identificador do modelo é estritamente uncensored. Isso roda em nossos próprios servidores e não é uma revenda do modelo de outro fornecedor. Você recebe uma chave de API imediata ao se cadastrar via Google ou e-mail. Mantenha essa chave segura, pois ela controla seu crédito pré-pago.

A autenticação depende do Authorization cabeçalho. Passe sua chave como um token Bearer. Cada solicitação deve incluir este cabeçalho para evitar um 401 erro. Não usamos parâmetros de consulta para autenticação. Isso garante cabeçalhos limpos e compatibilidade com middleware padrão.

Enviando Solicitações: Chat Completions

O endpoint de conclusões de chat processa seus prompts e retorna saídas de texto. Envie uma solicitação POST para /v1/chat/completions. Inclua o nome do modelo, o array de mensagens e os parâmetros desejados. O sistema processa texto e retorna texto. Você pode controlar o formato da resposta e os critérios de parada. Isso funciona tanto para consultas simples quanto para tarefas complexas de codificação.

Use o seguinte comando curl para testar sua conexão. Substitua YOUR_API_KEY com sua chave real. A solicitação utiliza o uncensored identificador do modelo. Isso confirma que sua autenticação e saldo de crédito estão ativos.

curl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Verifique se a resposta contém o choices array. Cada escolha inclui uma mensagem com o conteúdo gerado. Verifique o usage objeto para contagens de tokens. Isso ajuda você a monitorar seus gastos com precisão.

Integração do SDK Python

Integre a API em seus projetos Python usando o pacote oficial da OpenAI. Defina a URL base para o nosso endpoint. Inicialize o cliente com sua chave de API. Isso permite que você use métodos familiares como chat.completions.create. O SDK lida com a serialização JSON e as solicitações HTTP automaticamente.

Configure o modelo para uncensored. Passe suas mensagens no formato padrão. O SDK suporta todos os nossos recursos, incluindo chamada de funções e modo JSON. Você pode definir parâmetros como temperatura e top_p diretamente. Isso torna a migração de outros provedores direta.

from openai import OpenAI

client = OpenAI(base_url="https://api.coderdeepseek.cc/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)

Trate exceções para erros de rede ou solicitações inválidas. Verifique o código de status se você analisar a resposta bruta. Isso garante um tratamento de erros robusto em seu aplicativo. O SDK abstrai a maior parte da complexidade.

Integração do SDK Node

Use o SDK OpenAI Node.js para integrar com seus projetos JavaScript ou TypeScript. Instale o pacote e configure a URL base. Isso mantém a compatibilidade com a estrutura do seu código existente. Você pode usar os mesmos métodos do Python. O SDK suporta tanto CommonJS quanto módulos ES.

Defina o modelo para uncensored. Passe suas mensagens e parâmetros. O SDK lida com solicitações de streaming e não-streaming. Você pode capturar erros e registrá-los adequadamente. Isso garante que seu aplicativo permaneça estável sob carga.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.coderdeepseek.cc/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);

Teste sua integração com um prompt simples. Verifique se a resposta corresponde às suas expectativas. Verifique o uso de tokens no objeto de resposta. Isso ajuda você a rastrear custos e desempenho. O SDK torna fácil iterar rapidamente.

Respostas em Streaming e Uso de Tokens

Ative o streaming definindo stream: true na sua solicitação. A API retorna um fluxo de Server-Sent Events (SSE). Você recebe fragmentos de texto conforme são gerados. Isso reduz a latência percebida para respostas longas. O último fragmento contém o uso total de tokens.

Analise os eventos SSE para extrair o conteúdo. Concatene os chunks para formar a resposta completa. Monitore o usage objeto no último chunk. Isso fornece contagens de tokens precisas para faturamento. O streaming é ideal para aplicativos em tempo real.

stream = 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)

Trate interrupções de rede de forma graciosa. Reconecte se o stream cair. A API não reenvia chunks anteriores. Você deve reconstruir o texto completo no lado do cliente. Isso proporciona uma experiência de usuário suave.

Limites, Erros e Janela de Contexto

Nossa API impõe limites rigorosos para garantir estabilidade. Você pode fazer 300 requisições por minuto por chave. Até 8 requisições podem ser executadas simultaneamente. O corpo da requisição não deve exceder 8 MB. Exceder esses limites resulta em um 429 erro de limite de taxa. Lidere esses erros com backoff exponencial.

A janela de contexto é de 100.000 tokens. Isso inclui tanto o prompt quanto a conclusão. A saída máxima é de 16.000 tokens por solicitação. Se você não definir max_tokens, ele assume o padrão de 2.048. A 401 erro significa que sua chave é inválida. Uma 402 erro significa que você não tem crédito. Recarregue via criptomoedas para continuar usando o serviço.

Perguntas frequentes

Qual é a URL base para a API DeepSeek Coder?

A URL base é HTTPS://api.coderdeepseek.cc/v1. Isso funciona com qualquer cliente compatível com OpenAI. Você deve definir o modelo para uncensored.

Como lidar com limites de taxa?

Você está limitado a 300 solicitações por minuto. Se exceder isso, receberá um erro 429. Implemente backoff exponencial para tentar novamente as solicitações.

O que acontece se eu ficar sem crédito?

Você receberá um erro 402. Sua chave de API permanece válida. Adicione saldo via USDT ou USDC para restaurar o acesso. O crédito nunca expira.

Sua chave de API está a um passo de distância

Cadastre-se, pegue sua chave e atualize a URL base. Essa é toda a configuração.

Comece agora