Guia de Início Rápido da API Dolphin OpenRouter

URL Base e Autenticação

A URL base para todas as solicitações é https://api.openrouterdolphin.com/v1. Você autentica passando sua chave de API no Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

A autenticação é rigorosa. Não suportamos múltiplas chaves por conta. Gerar uma nova chave invalida imediatamente a anterior. Isso garante um rastreamento limpo do uso dos seus créditos pré-pagos.

Endpoint: POST /v1/chat/completions

Envie dados de texto para gerar respostas usando o uncensored model. Este endpoint lida com todas as conclusões de chat padrão. Você define o modelo, as mensagens e os parâmetros no corpo da solicitação.

Copyfrom openai import OpenAI

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

A API retorna um objeto JSON padrão contendo o texto gerado. Não suporta embeddings, imagens ou áudio. Foque em fluxos de trabalho de geração de texto. O modelo responde a prompts sem filtrar tópicos adultos legais ou controversos.

Endpoint: GET /v1/models

Recupere modelos disponíveis via uma simples solicitação GET. Este endpoint confirma o ID do modelo que você deve usar.

Copyimport OpenAI from "openai";

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

A resposta lista o uncensored model. Use este ID exato em suas solicitações de conclusão. A API serve apenas este único modelo. Não há lógica de roteamento ou seleção de modelos. Você interage diretamente com nossa instância dedicada de LLM sem censura.

Streaming e Dados de Uso

Ative o streaming definindo stream: true. A API retorna fragmentos via Eventos Enviados pelo Servidor (SSE). Cada fragmento contém uma parte do texto da resposta.

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 último chunk inclui as estatísticas completas de uso de tokens. Você paga estritamente pelos tokens de saída gerados. Erros e recusas não geram cobranças. Essa estrutura permite a renderização em tempo real das respostas nos seus aplicativos.

Parâmetros: Temperatura, Top P e Tools

Controle o comportamento da geração com parâmetros padrão. Defina temperature para aleatoriedade e top_p para amostragem por núcleo. Ative a chamada de funções fornecendo um tools array.

Usar response_format com {"type": "json_object"} para saída JSON estrita. Você também pode definir seed para reprodutibilidade. A API suporta presence_penalty e frequency_penalty para ajustar o uso de palavras. Esses parâmetros funcionam exatamente como funcionam em clientes OpenAI padrão.

Limites de Taxa e Tamanho da Solicitação

Cada chave de API permite 300 solicitações por minuto. Você pode ter até 8 solicitações simultâneas a qualquer momento. O tamanho máximo do corpo da solicitação é de 8 MB. A janela de contexto suporta 100.000 tokens para entrada e saída combinadas.

A saída máxima por solicitação é de 16.000 tokens. Se você não definir max_tokens, o padrão é 2.048 tokens. Exceder esses limites retorna um erro 429. Planeje sua estratégia de loteamento adequadamente. Os créditos nunca expiram, então você pode acumular uso ao longo do tempo sem pressão.