Atualizado
App de RPG com IA sem filtro: construa um com uma API
Uma API de namorada de IA fornece uma interface dedicada para aplicativos de chat que simulam interações românticas ou de companheirismo usando grandes modelos de linguagem. Este guia compara abordagens técnicas, focando em modelos sem censura que lidam com o contexto de interpretação de papéis sem recusas padrão de conteúdo.

A arquitetura em uma imagem
O navegador envia a mensagem do usuário para o seu servidor. O seu servidor adiciona a persona e o histórico recente, chama o modelo com stream: true e encaminha cada pedaço de volta. Nada mais é necessário.
- Navegador: uma caixa de texto e uma div que cresce conforme os tokens chegam.
- Seu servidor: mantém a chave de API, constrói a lista de mensagens e aplica seus próprios limites por usuário.
- API do modelo:
POST /v1/chat/completionsemhttps://api.nofilterai.top/v1com o modelouncensored. - Armazenamento: uma tabela ou arquivo de mensagens por conversa. SQLite é suficiente para começar.
O modelo é um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal. É apenas texto. Se quiser arte de personagem ou voz, adicione outro serviço você mesmo.
Projete o prompt de sistema
Para RPG, o prompt de sistema faz a maior parte do trabalho. Divida-o em três blocos curtos para que você possa trocar cada um independentemente: o mundo, o personagem e as regras do formato.
{
"world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
"character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
"format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}
Junte-os em uma única mensagem de sistema no momento da solicitação. Mantê-los separados permite que os usuários escolham um mundo e um personagem independentemente, o que é a maior parte do que um app de RPG precisa. Como a ficção adulta é permitida para uso adulto legal, diga isso uma vez nos seus próprios termos de serviço e adicione uma verificação de idade. A única coisa que a API não produzirá é conteúdo sexual envolvendo menores de idade, e seu app não deve tentar.
O backend de streaming
Esta rota Express aceita um ID de conversa e uma mensagem, carrega o histórico e encaminha o streaming para o navegador como eventos enviados pelo servidor. Ela usa o pacote oficial openai.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nofilterai.top/v1",
apiKey: process.env.API_KEY,
});
const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages
app.post("/chat", async (req, res) => {
const { id, text, persona } = req.body;
const history = store.get(id) ?? [];
history.push({ role: "user", content: text });
res.setHeader("Content-Type", "text/event-stream");
res.setHeader("Cache-Control", "no-cache");
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: persona }, ...trim(history)],
stream: true,
temperature: 0.9,
});
let reply = "";
for await (const chunk of stream) {
const piece = chunk.choices[0]?.delta?.content ?? "";
if (piece) {
reply += piece;
res.write("data: " + JSON.stringify(piece) + "\n\n");
}
}
history.push({ role: "assistant", content: reply });
store.set(id, history);
res.write("data: [DONE]\n\n");
res.end();
});
app.listen(3000);
O último pedaço de um fluxo de streaming carrega o uso, que você pode registrar para ver quanto cada conversa custa. Em produção, substitua o Map por um banco de dados e adicione tratamento de erros em torno da chamada.
Limite o histórico dentro da janela de 100k
A janela de contexto é de 100.000 tokens para prompt mais conclusão. Sessões de roleplay crescem lentamente, mas crescem. Uma função de redução que funciona por tamanho evita surpresas. Uma estimativa aproximada de 4 caracteres por token é boa o suficiente para o orçamento de custos.
function trim(history, maxChars = 120000) {
let total = 0;
const kept = [];
for (let i = history.length - 1; i >= 0; i--) {
total += history[i].content.length;
if (total > maxChars) break;
kept.unshift(history[i]);
}
return kept;
}
120.000 caracteres equivalem a cerca de 30.000 tokens, muito abaixo do limite, e mantêm cada chamada barata. Aumente apenas se sua história precisar de longo prazo de memória. Lembre-se da regra de custo: cada turno reenvia o histórico mantido como entrada a $0,15 por 1M de tokens, então um prompt de 30.000 tokens custa 30.000 / 1.000.000 x $0,15 = $0,0045 por turno antes da resposta.
O cliente do navegador
A página lê o fluxo SSE com fetch e anexa texto conforme ele chega. Como a requisição é um POST, o EventSource não se encaixa, então analise o fluxo à mão.
async function send(text) {
const out = document.getElementById("reply");
out.textContent = "";
const r = await fetch("/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
});
const reader = r.body.getReader();
const dec = new TextDecoder();
let buf = "";
while (true) {
const { value, done } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
const parts = buf.split("\n\n");
buf = parts.pop();
for (const p of parts) {
if (p === "data: [DONE]") break;
if (p.startsWith("data: ")) {
out.textContent += JSON.parse(p.slice(6));
}
}
}
}Recursos que dão sensação de app
- Regenerar e editar. Mantenha os IDs de mensagem. Regenerar significa excluir a última mensagem do assistente e chamar a API novamente com o mesmo histórico. Editar significa reescrever uma mensagem armazenada antes da próxima chamada.
- Configurações por personagem. Armazene
temperature,top_pe penalidades com cada personagem. Personagens mais calmos gostam de 0,7, os caóticos gostam de 1,0. Passeseedquando quiser execuções de teste reprodutíveis. - Exibição de custo. Leia o cabeçalho de resposta
X-Balance-USDou chameGET /v1/balancee mostre ao usuário quanto crédito resta. Se você revender acesso para seus próprios usuários, isso economiza muitas perguntas de suporte. - Controles de segurança que você possui. Adicione um portão apenas para adultos, um botão de denúncia e uma regra que bloqueie qualquer requisição envolvendo menores de idade antes que ela chegue à API. A plataforma impõe esse limite também, mas seu aplicativo também deve.
Limites, erros e orçamentos
Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma requisição de streaming ocupa um slot de concorrência até que o streaming termine, então um aplicativo de roleplay com 20 usuários ativos atingirá o limite durante minutos movimentados. A API responde HTTP 429 com o código concurrency ou rate_limited e, em caso de sobrecarga temporária, adiciona Retry-After: 5. Coloque as requisições em fila no seu servidor e tente novamente após esse atraso.
Requisições falhas ou recusadas não são cobradas, então as novas tentativas não custam a você. Para o orçamento de custos, uma rodada típica de 3.000 tokens de entrada e 300 tokens de saída custa $0,00045 + $0,00015 = $0,0006. O crédito é pré-pago a partir de $20 e nunca expira. Este site aceita cripto, USDT na TRC20 ou USDC na Base; a página de preços lista os bônus a partir de $50.
Para onde ir a seguir
Obtenha uma chave e teste com o crédito de teste grátis: a página de chave de API oferece $0,50 de crédito após o cadastro, válido por 7 dias, sem detalhes de pagamento. A chave de teste permite 2 requisições simultâneas, suficientes para um protótipo de usuário único. A documentação lista todos os parâmetros, incluindo chamada de funções se você quiser rolagens de dados ou inventário tratados como chamadas de função.
Para uma variante estilo companheiro com um único personagem persistente, consulte o artigo da API de companheiro de IA. Para um bot de chat dentro de um servidor, leia o guia do bot do Discord.
Mais guias
Perguntas e respostas
Posso chamar a API diretamente do navegador?
Você pode, mas exibiria sua chave para todos os visitantes. Mantenha a chave no servidor e exponha apenas sua própria rota.
Como evito que o modelo escreva as ações do meu personagem?
Declare isso no prompt de sistema e, se usar um formato de transcrição, adicione uma sequência de parada. Ambos funcionam com os parâmetros de passagem.
O app precisa armazenar conversas?
A própria API é sem estado, então você reenvia o histórico a cada turno. Os prompts não são usados para treinamento.
Qual é a forma mais barata de prototipar?
Use a chave de teste e um Map na memória. Mova para um banco de dados e uma chave financiada assim que o loop funcionar.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.
Obter chave de API