Dolphin sem censura API Documentação

Pré-requisitos e Configuração do Ambiente

Comece garantindo que seu ambiente tenha as dependências necessárias instaladas antes de fazer qualquer solicitação. Você precisará de uma chave de API ativa do nosso painel e de um runtime suportado como Python ou Node.js. Nossa API exige que você envie solicitações para uma URL base específica em vez do endpoint padrão do OpenAI.

Mantenha sua chave de API segura e armazene-a em uma variável de ambiente. Isso evita a exposição acidental no repositório de código. Você pode gerar uma nova chave instantaneamente após o cadastro com Google ou e-mail.

Você não precisa configurar roteamento complexo ou selecionar modelos específicos. O endpoint serve um único modelo de linguagem grande uncensored projetado para saída de texto direta.

Instalando o SDK Oficial da OpenAI

Instale o pacote SDK oficial para lidar com autenticação e formatação de solicitações automaticamente. Esta biblioteca suporta ambientes Python e Node.js com interfaces consistentes.

Para usuários Python, execute o comando pip install padrão para adicionar a biblioteca ao seu ambiente virtual. Os desenvolvedores Node.js devem usar npm para instalar o pacote equivalente.

O SDK gerencia a estrutura do payload JSON para você, então você só precisa se concentrar no conteúdo do prompt e em parâmetros como temperatura ou top_p.

Você pode verificar a instalação importando a biblioteca em seu script ou módulo. Isso garante que o cliente esteja pronto para se conectar aos nossos servidores.

Configurando URL Base e Chave de API

Aponte o cliente SDK para o nosso URL base específico para rotear solicitações para nossa infraestrutura sem censura. Use https://api.dolphinuncensored.com/v1 como seu endpoint.

Defina sua chave de API no cabeçalho de autorização ou no objeto de configuração do cliente. O cliente anexará essa chave a cada solicitação automaticamente.

Certifique-se de especificar o ID do modelo como "uncensored" na sua configuração. Isso informa ao servidor qual versão do modelo usar para sua geração.

Fazendo sua primeira solicitação de conclusão de chat

Envie uma mensagem simples para verificar a conectividade e receber uma resposta. Isso confirma que sua chave é válida e que o endpoint é acessível.

Use o endpoint chat-completions com um prompt de sistema e uma mensagem do usuário. A resposta conterá o texto gerado no campo content.

Entendendo Streaming e Uso de Tokens

Ative o streaming para receber tokens conforme são gerados em vez de esperar pela resposta completa. Isso melhora a latência percebida para saídas longas.

A API retorna estatísticas de uso no último trecho do stream. Você pode rastrear as contagens de tokens de entrada e saída para transparência na cobrança.

Defina o parâmetro stream como true no corpo da sua solicitação. Itere pelos chunks para construir seu texto final ou processe-o em tempo real.

Lidando com Erros e Recusas

Trate erros HTTP 401 verificando se sua chave de API está correta e não expirada. Um erro 402 indica crédito pré-pago insuficiente; recarregue via cripto para continuar.

Um status 429 significa que você atingiu o limite de taxa de 300 solicitações por minuto. Aguarde brevemente antes de tentar novamente ou reduza sua concorrência.

O modelo recua solicitações envolvendo conteúdo sexual com menores, que é um limite rígido. Outros tópicos controversos ou adultos são geralmente permitidos. Erros e recusas não consomem seu crédito de tokens.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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