Documentação da API para Desenvolvedores

URL Base e Autenticação

Comece alterando a URL base para nosso endpoint dedicado e passando sua chave de API no cabeçalho Authorization. Não usamos a URL base padrão do OpenAI; você deve apontar seu SDK para https://api.deepseektokenplan.com/v1. Isso garante que suas requisições sejam roteadas pela nossa infraestrutura de modelos sem censura, em vez de um proxy de terceiros. O ID do modelo especificado no corpo da requisição é "uncensored", o que ativa os pesos específicos ajustados em nossos servidores. A autenticação depende de um esquema simples de token Bearer que funciona com qualquer biblioteca cliente compatível com OpenAI. Sua chave é gerada instantaneamente no cadastro via Google ou e-mail, sem necessidade de número de telefone. Mantenha esta chave segura, pois ela está vinculada diretamente ao seu saldo de crédito pré-pago.

Primeira solicitação

Envie uma solicitação de conclusões de chat padrão usando cURL para verificar sua configuração e a disponibilidade do modelo. Esta solicitação POST simples demonstra como a API aceita seu prompt do sistema e a mensagem do usuário. Você pode ajustar os parâmetros temperature e top_p para controlar a criatividade. A resposta retorna o texto gerado junto com as estatísticas de uso de tokens para transparência na cobrança. Certifique-se de que o corpo da solicitação inclua o identificador do modelo correto e sua chave de API no cabeçalho. Este método funciona tanto para geração de texto quanto para chamadas de função. Use este comando para confirmar a conectividade antes de integrar ao seu aplicativo. O endpoint suporta modos de streaming e não-streaming igualmente bem.

Integração do SDK Python

Use a biblioteca oficial da OpenAI para Python para interagir com nossa API configurando a URL base e a chave da API. Inicialize o cliente com suas credenciais e chame o método de conclusões de chat com o ID do modelo desejado. Essa abordagem permite que você aproveite bases de código existentes que foram construídas para a OpenAI sem grandes refatorações. Você pode transmitir respostas ou receber o texto completo de uma vez. A biblioteca cuida automaticamente da serialização JSON e das requisições HTTP. Configure os tempos de espera e as configurações de retentativa conforme necessário para seu caso de uso específico. Esse método é ideal para serviços backend e pipelines de processamento de dados. Certifique-se de atualizar a URL base para apontar para nosso endpoint específico.

Integração do SDK Node

Integre a API em seus aplicativos JavaScript ou TypeScript usando o pacote Node da OpenAI. Defina a URL base e a chave de API na configuração do cliente antes de fazer qualquer solicitação. Esta configuração permite que você use métodos familiares como chat.completions.create() com nosso modelo uncensored. Você pode passar parâmetros como temperatura e sequências de parada para ajustar a saída. O SDK lida com respostas em streaming de forma eficiente para aplicações em tempo real. Use esta abordagem para servidores web ou ferramentas de linha de comando. Certifique-se de importar os módulos necessários e configurar as variáveis de ambiente corretamente. Este método suporta padrões de solicitação síncronos e assíncronos.

Streaming e Tokens

Ative o streaming para receber respostas parciais conforme são geradas, melhorando a experiência do usuário para interfaces de chat. A API utiliza Server-Sent Events (SSE) para entregar tokens em tempo real. Você pode rastrear o uso de tokens no último bloco do fluxo para faturamento preciso. Este recurso é suportado por todos os principais SDKs e pode ser implementado manualmente se necessário. O streaming reduz a latência percebida para respostas longas. Defina o stream parâmetro para true no corpo da sua solicitação. A API retorna estatísticas de uso no último evento, permitindo que você deduza o valor correto do seu crédito pré-pago. Este método é essencial para aplicativos que exigem feedback imediato.

Limites e Tratamento de Erros

Monitore seus limites de taxa e trate os erros com cuidado para garantir uma conexão estável. A API permite 300 requisições por minuto por chave e 8 requisições simultâneas. Cada corpo de requisição não deve exceder 8 MB. Se você enviar uma chave inválida, receberá um erro 401 Unauthorized. Um erro 402 indica crédito pré-pago insuficiente, exigindo que você recarregue via cripto. Um erro 429 significa que você excedeu o limite de taxa; aguarde e tente novamente. A janela de contexto é de 100.000 tokens para prompt e conclusão combinados. A saída máxima é de 16.000 tokens, a menos que você especifique um valor menor max_tokens valor. Sempre verifique o código de status e o corpo da resposta para mensagens de erro detalhadas.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)