Guia de início rápido da API sem censura

Autenticação e URL Base

Come apontando seu SDK para o nosso URL base e passando sua chave no cabeçalho de autorização. Fornecemos um serviço direto de modelo único sem taxas de roteamento de proxy. Use o padrão Authorization: Bearer scheme para autenticar solicitações. Sua chave é gerada imediatamente após o cadastro via Google ou e-mail. Certifique-se de substituir a chave de marcador de posição na configuração do seu cliente pela exibida no seu painel. A URL base é https://api.uncensoredmodelsollama.com/v1. Esse endpoint suporta clientes compatíveis com OpenAI, permitindo que você altere provedores sem reescrever a lógica do seu aplicativo. Mantenha sua chave segura, pois ela concede acesso ao saldo de crédito pré-pago.

Endpoint Chat Completions

Envie solicitações de texto para o /v1/chat/completions endpoint para gerar respostas. Este endpoint lida com históricos de conversação padrão e prompts de sistema. Você deve especificar o ID do modelo como uncensored no corpo da solicitação. A API retorna respostas formatadas em JSON contendo o texto gerado e estatísticas de uso de tokens. Erros como crédito insuficiente ou chaves inválidas são retornados com códigos de status HTTP apropriados. Use este endpoint para todas as tarefas padrão de geração de texto. Ele não suporta embeddings, imagens ou fine-tuning. Mantenha seu payload abaixo de 8 MB para garantir processamento confiável. O modelo processa tokens de entrada e saída dentro de uma janela de contexto compartilhada.

Respostas em Streaming

Habilite o streaming definindo o stream parâmetro para true em sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) contendo blocos incrementais de texto. Esta abordagem reduz a latência percebida para usuários aguardando saídas longas. Você recebe informações de uso de tokens no último bloco do stream. Implemente um manipulador de stream em seu cliente para processar esses eventos eficientemente. O streaming é ideal para interfaces de chat e aplicativos em tempo real. Certifique-se de que sua biblioteca de cliente suporte análise de SSE para lidar corretamente com o fluxo contínuo de dados. A janela de contexto total permanece com 100,000 tokens independentemente do modo de streaming.

Chamada de Função e Modo JSON

Use o tools parâmetro para habilitar capacidades de chamada de função. Defina suas funções no corpo da solicitação para permitir que o modelo retorne dados estruturados. Defina response_format para {"type": "json_object"} para saída JSON estrita. Esse recurso é útil para extrair dados ou gerar payloads estruturados. O modelo suporta parâmetros de escolha de ferramentas para controlar o comportamento de invocação de funções. Use esses recursos para integrar a API em fluxos de trabalho automatizados. Certifique-se de que as definições das suas funções correspondam ao esquema de entrada esperado para resultados confiáveis. A API retorna chamadas de ferramentas no formato padrão da OpenAI para facilitar a análise.

Parâmetros e Limites de Taxa

Ajuste o comportamento de geração usando parâmetros como temperature, top_p, e seed. Defina max_tokens limitar o comprimento da saída, com padrão de 2.048 se não especificado. A API impõe um limite de taxa de 300 solicitações por minuto por chave. Solicitações simultâneas são limitadas a 8 por chave. Se você exceder esses limites, a API retornará um código de status 429. As solicitações são cobradas com base no uso real de tokens, com erros e recusas sendo gratuitos. O crédito nunca expira, e os valores pré-pagos são transparentes. Gerencie suas chaves com cuidado, pois cada conta suporta apenas uma chave ativa por vez.

Limites, Erros e Contexto

A janela de contexto suporta 100.000 tokens para entrada e saída combinadas. Solicitações que excedam o limite de corpo de 8 MB falharão. Erros comuns incluem 401 para chaves inválidas e 402 para crédito insuficiente. Lidere esses erros de forma graciosa na lógica do seu aplicativo. A API recusa solicitações contendo conteúdo sexual envolvendo menores, independentemente de outras configurações. Outros conteúdos permanecem sem censura para uso adulto legal. Monitore o uso de tokens para evitar cobranças inesperadas. O sistema de crédito pré-pago garante que você pague apenas pelo que usar. Sem taxas de assinatura ou custos ocultos aplicados à sua integração.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)