Guia de Início Rápido da API Opensfw

Autenticação e URL Base

Come gerando sua chave no painel. Use o https://api.opensfw.com/v1 URL base e defina sua chave de API no Authorization cabeçalho. Esta configuração funciona com qualquer cliente SDK padrão do OpenAI.

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

Envie uma requisição POST para /v1/chat/completions com seu ID do modelo e mensagens. O modelo sem censura processa sua entrada e retorna o texto gerado. Use o exemplo curl abaixo para verificar a conectividade.

Copycurl https://api.opensfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current release version of the model?"}]
  }'

Respostas em streaming e uso de tokens

Ative o streaming definindo stream: true na sua solicitação. Você recebe fragmentos de texto conforme são gerados. O último fragmento contém as estatísticas completas de uso de tokens para faturamento. Use o exemplo em Python para lidar com o fluxo.

Copyfrom openai import OpenAI

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

Chamada de função e modo JSON

Defina ferramentas na solicitação para saídas estruturadas. Use response_format: {"type": "json_object"} para respostas JSON estritas. Isso funciona perfeitamente com parâmetros padrão de chamada de funções.

Copyimport OpenAI from "openai";

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

Lidando com erros e limites de taxa

Verifique a presença de 401 se sua chave for inválida, 402 por crédito insuficiente, e 429 para limites de taxa. Você tem 300 solicitações por minuto e 8 solicitações simultâneas por chave. Erros não consomem tokens.

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)

Entendendo janelas de contexto e limites

O modelo uncensored suporta uma janela de contexto de 100.000 tokens. Prompt e conclusão juntos. A saída máxima é de 16.000 tokens por solicitação. Mantenha o corpo da solicitação abaixo de 8 MB. Isso garante desempenho consistente para entradas grandes.