Guia de início rápido da API Uncensored AI
Este guia rápido ajuda você a integrar a API Dolphin sem censura usando SDKs compatíveis com OpenAI, contornando limites de taxa de terceiros e camadas de censura.
Autenticação e configuração da URL base
Configure seu cliente com a URL base fornecida e a chave de API para se conectar diretamente ao nosso endpoint hospedado. Você recebe uma única chave ativa imediatamente após o cadastro via Google ou e-mail, sem necessidade de número de telefone. A URL base é HTTPS://api.uncensoreddolphinopenrouter.com/v1 e o identificador do modelo é "uncensored". Esta configuração funciona com qualquer cliente compatível com OpenAI, simplesmente alterando o base_url e fornecendo sua chave de API no cabeçalho Authorization. Não há assinaturas mensais ou roteamento complexo envolvidos, apenas acesso direto ao modelo.
Enviando sua primeira conclusão de chat
Faça uma solicitação POST para o endpoint de chat completions para gerar respostas de texto do modelo uncensored. Você pode enviar prompts simples ou mensagens estruturadas usando o formato padrão da OpenAI. A API retorna uma resposta de texto direta, sem recusas adicionais de segurança para conteúdo adulto lícito. Certifique-se de incluir o campo model definido como "uncensored" no corpo da sua solicitação. Este endpoint suporta apenas chat completions, não embeddings ou geração de imagens. Você pode começar a testar imediatamente com seu crédito de teste ou saldo pago.
Usando SDK Python
Inicialize o cliente OpenAI com sua URL base e chave da API para enviar solicitações programaticamente. Esta abordagem permite que você integre o LLM uncensored em suas aplicações Python existentes com mínimas alterações de código. Defina a URL base para nosso endpoint hospedado e passe sua chave da API para autenticação. O cliente lidará com as solicitações HTTP e retornará o objeto de resposta para processamento adicional. Você pode ajustar parâmetros como temperatura e top_p para controlar o estilo de saída. Este método é ideal para construir interfaces personalizadas ou automatizar fluxos de trabalho.
Usando SDK Node
Configure o cliente OpenAI Node com a URL base específica e sua chave da API para interagir com a API. Isso permite integração perfeita em aplicativos Node.js usando padrões de SDK familiares. Aponte o cliente para HTTPS://api.uncensoreddolphinopenrouter.com/v1 e forneça sua chave para autenticação. Você pode então chamar o método de conclusões de chat com seus parâmetros desejados. A resposta inclui o texto gerado e estatísticas de uso de tokens. Esta configuração é perfeita para aplicativos do lado do servidor ou serviços de backend que exigem geração de texto sem censura.
Lidando com respostas de streaming
Ative o streaming definindo o parâmetro stream como true na sua solicitação para receber atualizações de tokens em tempo real. A API retorna Server-Sent Events (SSE) para feedback imediato conforme os tokens são gerados. Cada chunk contém texto parcial e dados de uso no último chunk. Esta abordagem reduz a latência percebida para os usuários, exibindo a saída progressivamente. Você pode analisar o fluxo SSE para atualizar sua interface do usuário em tempo real. O streaming é suportado para todas as solicitações de conclusão de chat, incluindo aquelas com chamada de função ou modo JSON.
Entendendo limites e custos de tokens
A janela de contexto suporta até 100.000 tokens para prompt e conclusão combinados. A saída máxima é de 16.000 tokens por solicitação, ou 2.048 se max_tokens não estiver definido. Essa capacidade é adequada para documentos longos, bases de código e tarefas complexas de escrita criativa. O preço é de $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, cobrados apenas pelo uso real. Erros e recusas não têm custo, garantindo que você pague apenas por conclusões bem-sucedidas. O crédito pré-pago nunca expira e você pode recarregar com criptomoedas a partir de $20. Esse modelo de preços transparente ajuda você a gerenciar os custos efetivamente, sem taxas ocultas.
Limites de taxa e simultaneidade
Cada chave de API está limitada a 300 solicitações por minuto e 8 solicitações simultâneas para garantir desempenho estável. O tamanho máximo do corpo da solicitação é de 8 MB, o que acomoda janelas de contexto grandes. Se você exceder esses limites, receberá um erro 429 indicando limite de taxa excedido. Você pode gerar uma nova chave para substituir uma existente, pois apenas uma chave está ativa por conta. Esses limites previnem abusos enquanto mantêm alta disponibilidade. Monitore seu uso para permanecer dentro desses limites para um desempenho ótimo.
cURL
curl https://api.uncensoreddolphinopenrouter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List five key differences between python and rust"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoreddolphinopenrouter.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.uncensoreddolphinopenrouter.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)Perguntas frequentes
A API Dolphin sem censura é compatível com modelos do OpenRouter?
Sim, nossa API é totalmente compatível com OpenAI, ou seja, funciona com SDKs padrão usados para modelos do OpenRouter. No entanto, somos um serviço independente e não oferecemos o mesmo modelo ou infraestrutura do OpenRouter. Você pode usar o mesmo código de cliente, mas apontá-lo para nossa URL base para acesso direto sem limites de taxa de terceiros.
O que acontece se eu receber um erro 402?
Um erro 402 indica que sua conta tem crédito insuficiente para processar a solicitação. Você pode adicionar fundos ao seu saldo usando USDT na TRC20 ou USDC na Base, com valores variando de $20 a $500. Crédito bônus é adicionado para recargas maiores, e seu crédito nunca expira. Erros como 401 (chave inválida) exigem verificação da sua chave API, enquanto 429 (limite de taxa) significa que você excedeu o limite de 300 solicitações por minuto.
Posso usar esta API para chamada de funções e modo JSON?
Sim, a API suporta chamada de funções (ferramentas) e modo JSON por meio do parâmetro response_format. Você pode definir ferramentas em sua solicitação e receber respostas JSON estruturadas. Isso permite integração avançada com aplicações que exigem dados estruturados ou uso dinâmico de ferramentas. O modelo sem censura lida com esses formatos de forma confiável, tornando-o adequado para fluxos de trabalho complexos.
Obtenha sua chave agora
Faça o cadastro, pegue a chave e atualize a URL base. É só isso que existe.