Início rápido para usuários do OpenRouter NSFW

URL Base e Autenticação

Substitua o base URL do seu provedor atual por https://api.openrouternsfw.com/v1. A autenticação usa o cabeçalho padrão Authorization: Bearer <key>. Você obtém sua chave imediatamente após entrar via Google ou e-mail na página Obter chave de API. Não é necessário número de telefone, e a chave é exibida apenas uma vez, então copie-a antes de sair da página.

Nosso serviço é uma API independente, não um revendedor de modelos de outros fornecedores. O identificador do modelo que você envia nas requisições é uncensored, que é executado em nossos próprios servidores. É ajustado para responder sem recusas de conteúdo para uso adulto lícito, mas não é GPT, Claude ou qualquer outro modelo de fornecedor nomeado.

Certifique-se de que a biblioteca do seu cliente esteja configurada para usar esta nova base URL. Todas as requisições devem incluir uma chave de API válida no cabeçalho. Se a chave estiver ausente ou inválida, o servidor retornará um erro 401. Se você não tiver crédito pré-pago, receberá um erro 402. Estes são códigos de status HTTP padrão indicando problemas de autenticação ou pagamento, não erros do servidor.

Endpoint de Conclusões de Chat

A funcionalidade principal é fornecida via endpoint POST /v1/chat/completions. Este endpoint aceita um corpo JSON contendo o nome do modelo, o array de mensagens e parâmetros opcionais. Retorna um objeto JSON com o texto gerado, estatísticas de uso de tokens e motivo do término. Esta estrutura é compatível com os SDKs oficiais da OpenAI e a maioria das bibliotecas cliente compatíveis com OpenAI.

Você não precisa escrever clientes HTTP personalizados se preferir usar um SDK. No entanto, você deve atualizar a configuração para apontar para nossa base URL. O exemplo a seguir demonstra uma solicitação de conclusão padrão usando cURL. Esta solicitação envia um prompt para o modelo sem censura e espera uma resposta de texto.

Copiarcurl https://api.openrouternsfw.com/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."}]
  }'

Lembre-se de que esta API serve apenas texto. Não há endpoints para embeddings, geração de imagens, áudio ou vídeo. Se seu aplicativo requer entradas ou saídas multimodais, você precisará lidar com isso separadamente. Nosso serviço foca exclusivamente na geração de texto de alta qualidade com um modelo sem censura.

Integração com SDK Python

Usar o SDK Python simplifica o processo de integração. Inicialize o cliente com a base URL correta e sua chave de API. A biblioteca cuida das requisições HTTP e análise JSON para você. Você pode especificar o ID do modelo como uncensored para garantir que está usando nosso modelo específico.

Copiarfrom openai import OpenAI

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

Este trecho de código mostra como enviar uma mensagem e recuperar a resposta. O cliente lida automaticamente com a conexão e o relatório de erros. Se o servidor retornar um erro, o SDK levantará uma exceção. Você deve tratar essas exceções na lógica do seu aplicativo para fornecer uma melhor experiência ao usuário.

O SDK Python é apenas uma opção. Você pode usar qualquer linguagem que suporte requisições HTTP. A estrutura do endpoint permanece a mesma, independentemente do cliente que você escolher. Esta flexibilidade permite que você integre o modelo sem censura em qualquer fluxo de trabalho existente sem alterações significativas de código.

Uso do SDK Node.js

O SDK Node funciona de forma semelhante à versão Python. Configure o cliente com a base URL e a chave de API, depois chame o método de conclusões de chat. Esta abordagem é ideal para aplicativos do lado do servidor ou serviços de back-end que precisam gerar texto de forma assíncrona.

Copiarimport OpenAI from "openai";

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

Desenvolvedores Node.js podem integrar facilmente esta API em seus projetos existentes. O SDK cuida da serialização e desserialização de dados JSON. Você também pode especificar parâmetros adicionais como temperature ou top_p para controlar a aleatoriedade da saída.

Certifique-se de lidar corretamente com a natureza assíncrona das requisições. Use async/await ou cadeias de Promise para gerenciar os dados de resposta. Isso garante que seu aplicativo permaneça responsivo enquanto aguarda o modelo gerar o texto. O SDK Node é uma escolha confiável para construir serviços de geração de texto escaláveis.

Respostas em Streaming

Ative o streaming definindo o parâmetro stream como true em sua solicitação. O servidor enviará uma série de Eventos Enviados pelo Servidor (SSE) em vez de uma única resposta JSON. Cada evento contém um fragmento parcial do texto gerado.

Copiarstream = 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)

O streaming é útil para aplicativos em tempo real onde você deseja exibir a saída conforme ela é gerada. O último fragmento do stream contém o uso total de tokens para a solicitação. Isso permite que você rastreie os custos com precisão sem aguardar que toda a resposta seja concluída.

Trate os eventos do stream com cuidado para garantir que o texto seja montado corretamente. Concatene os fragmentos na ordem em que são recebidos. O servidor garante que os fragmentos sejam enviados em sequência. Se a conexão for interrompida, você pode precisar repetir a solicitação. O streaming é um recurso poderoso que melhora a experiência do usuário para tarefas de geração de texto.

Limites de Requisição e Janela de Contexto

Cada chave de API é limitada a 300 requisições por minuto e 8 requisições simultâneas. O tamanho do corpo da solicitação é limitado a 8 MB. Se você exceder esses limites, o servidor retornará o código de status 429. Este é um código de status HTTP padrão indicando que você enviou muitas requisições em uma determinada janela de tempo. Você deve implementar backoff exponencial no seu cliente para lidar com esses erros com elegância.

A janela de contexto suporta até 100,000 tokens para o prompt e a conclusão combinados. Não há um limite separado de saída. Se você não especificar o parâmetro max_tokens, a resposta pode ir até o final da janela. Você pode limitar o comprimento da saída definindo max_tokens para um valor menor.

Monitore o uso de tokens para gerenciar seu crédito pré-pago de forma eficaz. Erros e recusas não consomem tokens, então você não é cobrado por solicitações falhas. Isso garante que você pague apenas pela geração de texto bem-sucedida. Fique de olho nos seus limites de requisições para evitar interrupções no seu serviço.