Início rápido: integre em minutos

1. Instale seu SDK

Come instalando a biblioteca oficial para a sua linguagem. A maioria dos desenvolvedores prefere o pacote padrão porque corresponde à interface que já conhecem. Execute pip install openai para Python ou npm install openai para Node.js. Você precisa apenas de um SDK para lidar com todas as solicitações.

2. Defina sua URL base

Configure seu cliente para apontar para nosso endpoint específico. Você deve substituir a URL base padrão para rotear o tráfego corretamente. Use https://api.unsencoredai.com/v1 como sua URL base. Passe sua chave de API no Authorization cabeçalho. Esta configuração funciona com qualquer cliente compatível com OpenAI padrão.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Envie sua primeira solicitação

Envie uma solicitação padrão de conclusão de chat para gerar texto. O ID do modelo é uncensored. Você pode enviar prompts de sistema para orientar o comportamento. A API retorna uma resposta de texto direta. Use o comando curl abaixo para testar a conectividade imediatamente. Verifique sua resposta para o choices array.

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

4. Lidar com respostas em streaming

Ative o streaming para menor latência e saída em tempo real. Defina stream: true na sua solicitação. A API envia blocos via Server-Sent Events. Você pode processar cada token conforme ele chega. Isso é ideal para interfaces de chat ou cenários de roleplay. O último bloco contém estatísticas de uso.

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)

5. Configure os parâmetros

Ajustar temperature, top_p, e stop sequências. Esses controles influenciam a criatividade e o comprimento da saída. Você também pode usar response_format para o modo JSON. A janela de contexto suporta 100.000 tokens no total. A saída máxima é de 16.000 tokens por solicitação. Ajuste essas configurações para o seu caso de uso específico.

6. Limites, erros e contexto

Trate os erros com elegância usando códigos de status HTTP padrão. Um erro 401 significa que sua chave de API é inválida. Um erro 402 indica crédito pré-pago insuficiente. Um erro 429 sinaliza que você atingiu o limite de 300 solicitações por minuto. Sua janela de contexto é de 100.000 tokens. Solicitações acima de 8 MB podem falhar. Reembolsos não são emitidos para crédito, mas erros são gratuitos.