URL Base e Autenticação
A autenticação requer uma única chave de API passada no Authorization Cabeçalho.
Cada solicitação deve direcionar-se para a URL base https://api.dolphinaisincensura.com/v1 e inclua a chave como Bearer YOUR_API_KEY.
Esta configuração funciona com qualquer SDK compatível com OpenAI, simplesmente atualizando o base_url configuração.
Erros como 401 indicam uma chave inválida ou ausente, enquanto 402 sinaliza crédito pré-pago insuficiente.
curl https://api.dolphinaisincensura.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list the python imports for requests and json"}]
}'Enviando uma Conclusão de Chat
Envie uma requisição POST para /v1/chat/completions com um model field set to uncensored.
Incluir um messages array contendo o histórico do seu prompt para manter o contexto da conversa.
A API retorna uma resposta de texto diretamente no content field of the first choice.
A abordagem de modelo único elimina taxas de proxy e garante preços previsíveis a $0.15 por 1M de tokens de entrada.
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinaisincensura.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)Lidando com Streaming (SSE)
Ative o streaming definindo stream para true na carga útil da sua solicitação.
O servidor responde com Server-Sent Events (SSE) que entregam tokens incrementalmente.
Analise cada chunk SSE para extrair o texto gerado sem esperar pela resposta completa.
As estatísticas de uso de tokens são fornecidas no último chunk do stream para faturamento preciso.
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)Chamada de Função e Modo JSON
Use o tools parâmetro para definir esquemas de função para extração de dados estruturados.
Definir response_format para {"type": "json_object"} para forçar saída JSON estrita para análise confiável.
Especificar temperature e top_p para controlar a criatividade versus o determinismo nos seus resultados.
Esses recursos permitem que você construa agentes autônomos que interagem com APIs ou bancos de dados externos.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinaisincensura.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);Entendendo Limites de Tokens e Contexto
A janela de contexto suporta 100.000 tokens combinados para prompt e conclusão.
A saída máxima por solicitação é de 16.000 tokens, ou 2.048 se max_tokens está indefinido.
Os limites de taxa permitem 300 solicitações por minuto e 8 solicitações simultâneas por chave de API.
Solicitações excedendo o limite de corpo de 8 MB ou atingindo os limites de concorrência retornam erros 429.
Respostas de erro e recusas não consomem seu crédito pré-pago.
Limites de Taxa e Concorrência
Cada chave de API está limitada a 300 solicitações por minuto e 8 conexões simultâneas ativas.
Um código de status 429 indica que você excedeu esses limites de concorrência ou taxa.
Você pode gerar uma nova chave para substituir uma existente, mas apenas uma chave ativa é permitida por conta.
Monitore seu uso por meio dos cabeçalhos de resposta para permanecer dentro do limite de corpo de solicitação de 8 MB.
