Guia de Integração para Desenvolvedores

URL Base e Autenticação

Come apontando seu cliente para nossa URL base e fornecendo sua chave de API no cabeçalho de autorização. Isso funciona com qualquer SDK compatível com OpenAI porque seguimos o protocolo padrão exatamente. Gere sua chave instantaneamente via Google ou e-mail na página Obter chave de API; não é necessário número de telefone. Mantenha sua chave segura e use uma chave ativa por conta, pois gerar uma nova substitui a anterior.

A autenticação é simples. Envie sua chave no Authorization cabeçalho para cada solicitação. Nosso sistema valida a chave antes de processar tokens, garantindo que apenas contas autorizadas consumam crédito. Erros como uma chave ausente retornam um status 401 imediatamente.

Primeira solicitação

Envie uma solicitação padrão de conclusão de chat para testar a conectividade e a qualidade da resposta. Esta chamada simples verifica sua chave e seus créditos na conta corretamente. O ID do modelo é uncensored, que lida com entrada e saída de texto sem recusas de conteúdo para uso adulto lícito. Substitua o espaço reservado pela sua chave real e pelo prompt do sistema.

Copycurl https://api.deepseekapicost.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 1 million tokens"}]
  }'

Este comando curl demonstra a estrutura mínima necessária. Você pode ajustar o messages array para incluir contexto ou instruções. A resposta retorna o texto gerado no content campo. Verifique as estatísticas de uso nos cabeçalhos da resposta para monitorar o consumo de tokens.

SDK Python

Use a biblioteca oficial da OpenAI para Python para integrar nossa API em seus scripts ou aplicações. Defina o base_url e api_key atributos antes de fazer chamadas. Essa abordagem garante compatibilidade com bases de código existentes que já usam modelos OpenAI. Você pode alternar entre provedores alterando apenas duas linhas de configuração.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapicost.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 snippet Python acima mostra como inicializar o cliente e enviar uma solicitação. A biblioteca gerencia a serialização JSON e a análise da resposta automaticamente. Você pode acessar o objeto de resposta para extrair conteúdo, estatísticas de uso e motivos de finalização. Este método é ideal para serviços backend ou pipelines de processamento de dados.

SDK Node

Integre nossa API em aplicações Node.js usando o openai pacote npm. Configure o cliente com nossa URL base e sua chave de API assim como você faria para o OpenAI. Isso permite que você use a mesma estrutura de código para testes e produção. O SDK suporta operações assíncronas para solicitações não bloqueantes.

Copyimport OpenAI from "openai";

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

Este exemplo em Node.js demonstra o envio de uma solicitação de conclusão de chat. O await palavra-chave garante que a resposta seja totalmente recebida antes de prosseguir. Você pode lidar com erros usando blocos try-catch para gerenciar problemas de rede ou limites de API com graça. O objeto de resposta contém o texto gerado e os detalhes de uso de tokens.

Streaming

Ative o streaming para receber respostas token por token para melhor experiência do usuário em interfaces de chat. Defina o stream parâmetro para true na sua solicitação. A API retorna chunks de texto conforme são gerados, permitindo que você exiba a saída em tempo real. Isso reduz significativamente a latência percebida para os usuários finais.

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 código de streaming acima processa cada chunk conforme ele chega. Você pode anexar o conteúdo a um elemento da interface do usuário imediatamente. O último chunk contém as estatísticas de uso total de tokens. Este recurso é suportado por todos os clientes compatíveis com OpenAI que lidam corretamente com respostas SSE.

Limites, Erros e Janela de Contexto

Nossa API impõe limites rigorosos para garantir uso justo e estabilidade do sistema. Você tem permissão para 300 requisições por minuto e 8 requisições concorrentes por chave. Cada corpo de requisição não deve exceder 8 MB. Se você exceder esses limites, a API retorna o código de status 429. Aguarde alguns segundos e tente novamente sua requisição. Erros como chaves inválidas retornam 401, e crédito insuficiente retorna 402.

A janela de contexto suporta até 100.000 tokens para entrada e saída combinadas. A saída máxima por solicitação é de 16.000 tokens, ou 2.048 se você não especificar max_tokens. Essa janela grande permite que você processe documentos longos ou mantenha um histórico extenso de conversas sem truncamento. Erros e recusas não consomem crédito, então você paga apenas pelo uso real.