Primeira requisição em cinco minutos

URL base e autenticação

Nossa API espelha a interface OpenAI v1, permitindo trocar endpoints sem alterar a lógica do aplicativo. Use https://api.groknsfw.top/v1 como URL base. A autenticação exige uma chave de API válida passada no cabeçalho Authorization como token Bearer. Você pode gerar essa chave instantaneamente via login no Google ou e-mail no painel. Cada conta suporta uma chave ativa por vez; emitir uma nova chave invalida a anterior imediatamente. Esse modelo de chave única simplifica o controle de acesso na maioria dos ambientes de desenvolvimento e QA.

Primeira requisição

Envie uma solicitação padrão de conclusão de chat para testar a conectividade. O identificador do modelo é uncensored, que trata recusas de conteúdo de forma diferente dos modelos padrão. Abaixo está um exemplo básico usando a ferramenta de linha de comando curl para verificar se sua chave e URL base estão corretos.

Copycurl https://api.groknsfw.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Se você receber uma resposta JSON com choices e usage, sua integração está ativa. Verifique o objeto usage para ver o consumo de tokens e acompanhar a cobrança com precisão.

Integração com SDK Python

Use o pacote Python oficial openai para interagir com nosso endpoint. Defina os atributos base_url e api_key antes de fazer chamadas. Essa abordagem funciona com qualquer biblioteca que suporte o esquema OpenAI, facilitando a migração de outros provedores.

Copyfrom openai import OpenAI

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

Este snippet demonstra uma solicitação síncrona. Para geração de conteúdo NSFW de alta taxa de transferência, considere usar clientes assíncronos para lidar com múltiplas requisições simultaneamente sem bloquear sua thread principal.

Configuração do SDK Node.js

Para aplicativos JavaScript ou TypeScript, configure o SDK OpenAI para apontar para nossa URL base. Isso garante que seu código de cliente existente funcione sem modificações. O ecossistema Node.js se beneficia dessa compatibilidade, permitindo prototipagem rápida de interfaces de chat NSFW.

Copyimport OpenAI from "openai";

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

Certifique-se de estar usando uma versão recente do SDK que suporte URLs base personalizados. O objeto de configuração deve incluir estritamente as propriedades apiKey e baseURL para evitar incompatibilidades de endpoint.

Respostas em streaming (SSE)

Ative a geração de tokens em tempo real definindo stream: true na sua requisição. A API retorna um stream de Server-Sent Events (SSE), entregando tokens conforme são gerados. Isso reduz a latência percebida para usuários finais em aplicativos de chat.

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)

Analise os eventos SSE para extrair o conteúdo delta. O último pedaço no fluxo contém as estatísticas totais de usage, que você deve usar para conciliação precisa de cobrança. O streaming não afeta a contagem de tokens ou o preço.

Limites, erros e contexto

Suas requisições estão sujeitas a um limite de 300 por minuto e 8 requisições simultâneas por chave. O tamanho máximo do corpo da requisição é 8 MB, e a janela de contexto suporta até 100.000 tokens no total. Erros são retornados em formatos HTTP padrão: 401 para chaves inválidas, 402 para crédito insuficiente e 429 para limites de taxa. Erros de crédito são gratuitos, mas os limites de taxa exigem que você reduza a taxa das requisições. A saída máxima por requisição é 32.000 tokens; omitir max_tokens define o padrão para 2.048 tokens.