URL Base e Autenticação
Inicie cada solicitação apontando seu cliente para a URL base correta. Use a chave que você recebeu durante o cadastro para passar no Authorization cabeçalho. Este cabeçalho autentica sua conta e acompanha o uso do seu crédito pré-pago.
Nossa infraestrutura é construída para desenvolvedores que querem acesso direto sem taxas de roteamento intermediário. Você obtém desempenho consistente porque executamos nossos próprios servidores.
Primeira solicitação
Envie sua primeira mensagem para verificar a conectividade e a resposta do modelo. Use o endpoint padrão de conclusões de chat com seu prompt do sistema e consulta do usuário. Isso confirma que sua chave funciona e mostra a resposta JSON bruta.
- Defina o
modelfield touncensored. - Inclua uma mensagem de usuário simples para testar a latência.
- Verifique o
usageobjeto para contagens de tokens.
SDK Python
Integre rapidamente usando a biblioteca Python oficial. Instale o pacote e inicialize o cliente com sua URL base e chave. Esta abordagem gerencia serialização e retentativas automaticamente.
Defina o histórico da sua conversa como uma lista de dicionários. Passe-os diretamente para o endpoint de chat. A biblioteca retorna um objeto de resposta estruturado que você pode analisar para obter o texto do assistente.
SDK Node
Crie lógica do lado do servidor com o cliente Node.js. Importe a biblioteca e configure a chave de API e a URL base. Esta configuração funciona bem para serviços backend que processam entradas de usuário de forma assíncrona.
Chame o método de conclusão com suas mensagens. A resposta inclui o texto gerado e as estatísticas de uso. Lidere os erros graciosamente para evitar que sua aplicação falhe durante cargas altas.
Respostas em Streaming
Receba tokens em tempo real para uma experiência de usuário mais fluida. Ative o streaming definindo o sinalizador apropriado na sua solicitação. O servidor envia chunks de dados conforme são gerados.
Acumule esses chunks no lado do cliente para exibir o texto progressivamente. Isso reduz significativamente a latência percebida. Monitore o último chunk para uso total de tokens e dados de cobrança.
Limites, Erros e Contexto
Respeite os limites de taxa para evitar interrupções. Você tem permissão para 300 solicitações por minuto e 8 conexões simultâneas por chave. Se você exceder isso, receberá um erro 429.
Um erro 401 significa que sua chave de API é inválida. Um erro 402 indica crédito pré-pago insuficiente. Sua janela de contexto é de 100.000 tokens no total. Mantenha seu prompt e resposta dentro deste limite para garantir desempenho confiável.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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);Streaming
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)