Documentação da API Compatível com OpenAI

Autenticação e Configuração da URL Base

Sua chave de API autentica todas as solicitações para os nossos servidores. Basta se cadastrar com Google ou um endereço de e-mail e copiar a chave do seu painel. Cole-a na sua variável de ambiente como DEEPSEEK_API_KEY e aponte seu cliente para https://api.keyapideepseek.com/v1. Esta URL base funciona com qualquer biblioteca padrão compatível com OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Você pode verificar sua configuração listando os modelos disponíveis. A resposta confirma que sua chave é válida e ativa. Esta etapa garante que sua integração aponte para o endpoint sem filtros correto antes de enviar prompts.

Endpoint Chat Completions

O POST /v1/chat/completions o endpoint aceita seu prompt e retorna a resposta do modelo. Você envia um corpo JSON contendo mensagens, suas instruções de sistema e parâmetros como temperatura. O ID do modelo é sempre uncensored. Este modelo único lida com todas as suas necessidades de geração de texto sem complexidade de roteamento.

Copyfrom openai import OpenAI

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

O SDK Python gerencia as solicitações HTTP automaticamente. Você passa sua chave e a URL base para o construtor do cliente. O restante do código espelha os padrões padrão do OpenAI. Isso garante que você possa trocar de fornecedor mais tarde sem reescrever toda a lógica do seu aplicativo.

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) de fragmentos. Cada fragmento contém texto parcial e estatísticas de uso. O último fragmento inclui as contagens totais de tokens para a solicitaçã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)

O streaming reduz a latência percebida pelos usuários. Você pode exibir tokens conforme chegam. Isso é crucial para geração de texto longo ou interfaces de chat interativas. Monitore o uso de tokens no último fragmento para rastrear o consumo do seu crédito pré-pago com precisão.

Modo JSON e Chamada de Funções

Garanta saída estruturada definindo response_format para {"type": "json_object"}. O modelo retornará JSON válido em vez de texto de formato livre. Isso é ideal para integrações de API ou tarefas de extração de dados. Você também pode definir definições de função no seu prompt para uso de ferramentas.

O modelo suporta tool_choice parâmetros. Você pode forçar funções específicas ou deixar o modelo decidir. Essa flexibilidade permite que você construa agentes complexos. Certifique-se de que seus esquemas de função sejam fortemente tipados para evitar erros de análise no código do seu cliente.

Limites de Taxa e Concorrência

Cada chave de API está limitada a 300 solicitações por minuto. Você pode ter até 8 solicitações simultâneas ativas ao mesmo tempo. O tamanho máximo do corpo da solicitação é de 8 MB. Esses limites previnem abusos e garantem desempenho estável para todos os usuários. Exceder esses limites retorna um erro 429.

Implemente backoff exponencial no seu código do cliente. Tente novamente as solicitações falhas após um curto atraso. Isso lida com problemas transitórios de rede com graça. Seu crédito pré-pago é cobrado apenas por conclusões bem-sucedidas, não por tentativas de limite de taxa.

Tratamento de Erros e Recusas

Um erro 401 significa que sua chave é inválida ou expirada. Um erro 402 indica crédito pré-pago insuficiente. Um erro 429 sinaliza que você atingiu o limite de taxa. O modelo recusa solicitações que contenham conteúdo sexual envolvendo menores. Todo o outro conteúdo adulto legal é permitido.

Verifique o corpo da resposta de erro para mensagens detalhadas. Registre esses erros para depurar problemas de integração. Seu crédito não é consumido para solicitações falhas. Esse modelo de faturamento transparente ajuda você a prever custos com precisão sem taxas ocultas.

Node.js

Copyimport OpenAI from "openai";

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