IT ▾
nofilterai.top
NoFilter AI
Ottieni la chiave API

App di roleplay AI senza filtri: creala con un'API

Un'API per fidanzata AI fornisce un'interfaccia dedicata per applicazioni di chat che simulano interazioni romantiche o di compagnia utilizzando modelli linguistici di grandi dimensioni. Questa guida confronta gli approcci tecnici, concentrandosi su modelli senza censura che gestiscono il contesto del roleplay senza i tipici rifiuti sui contenuti.

Un palcoscenico teatrale in miniatura collegato da un flusso di dati luminoso a un server, che illustra l'architettura di un'app di roleplay

L'architettura in una foto

Il browser invia il messaggio dell'utente al tuo server. Il tuo server aggiunge la personalità e la cronologia recente, chiama il modello con stream: true e inoltra ogni chunk indietro. Non serve nient'altro.

  1. Browser: una casella di testo e un div che cresce man mano che arrivano i token.
  2. Il tuo server: mantiene la chiave API, costruisce la lista dei messaggi, applica i tuoi limiti per utente.
  3. Model API: POST /v1/chat/completions a https://api.nofilterai.top/v1 con modello uncensored.
  4. Archiviazione: una tabella o un file di messaggi per conversazione. SQLite è sufficiente per iniziare.

Il modello è un modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale. È solo testo. Se vuoi arte dei personaggi o voce, aggiungi tu un altro servizio.

Progetta il prompt di sistema

Per il roleplay, il prompt di sistema fa la maggior parte del lavoro. Dividilo in tre brevi blocchi in modo da poter scambiare ciascuno in modo indipendente: il mondo, il personaggio e le regole del 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."
}

Uniscili in un unico messaggio di sistema al momento della richiesta. Tenerli separati permette agli utenti di scegliere un mondo e un personaggio indipendentemente, che è la maggior parte di ciò di cui ha bisogno un'app di roleplay. Poiché la narrativa per adulti è consentita per uso adulto legale, dillo una volta nei tuoi termini di servizio e aggiungi un controllo dell'età. L'unica cosa che l'API non produrrà è contenuto sessuale che coinvolge i minorenni, e la tua app non dovrebbe provarci.

Il backend con streaming

Questa route Express accetta un ID conversazione e un messaggio, carica la cronologia e invia lo streaming al browser come eventi server-sent. Usa il pacchetto ufficiale 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);

L'ultimo chunk di uno streaming contiene l'utilizzo, che puoi registrare per vedere quanto costa ogni conversazione. In produzione, sostituisci la Map con un database e aggiungi la gestione degli errori intorno alla chiamata.

Riduci la cronologia nella finestra da 100k

La finestra di contesto è di 100.000 token per prompt più completamento. Le sessioni di roleplay crescono lentamente, ma crescono. Una funzione di trim basata sulle dimensioni evita sorprese. Una stima approssimativa di 4 caratteri per token è buona per il budgeting.

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 caratteri corrispondono a circa 30.000 token, ben al di sotto del limite, e mantengono ogni chiamata economica. Aumentalo solo se la tua storia richiede una lunga memoria. Ricorda la regola del costo: ogni turno reinvia la cronologia mantenuta come input a $0,15 per 1M token, quindi un prompt da 30.000 token costa 30.000 / 1.000.000 x $0,15 = $0,0045 per turno prima della risposta.

Il client browser

La pagina legge lo streaming SSE con fetch e aggiunge testo man mano che arriva. Poiché la richiesta è un POST, EventSource non è adatto, quindi analizza lo streaming a mano.

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));
      }
    }
  }
}

Funzionalità che lo fanno sembrare un'app

  • Rigenera e modifica. Mantieni gli ID dei messaggi. Rigenerare significa cancellare l'ultimo messaggio dell'assistente e chiamare di nuovo l'API con la stessa cronologia. Modificare significa riscrivere un messaggio memorizzato prima della chiamata successiva.
  • Impostazioni per personaggio. Memorizza temperature, top_p e le penalità con ogni personaggio. Personaggi più calmi come 0,7, quelli caotici come 1,0. Passa seed quando vuoi esecuzioni di test riproducibili.
  • Visualizzazione dei costi. Leggi l'intestazione di risposta X-Balance-USD o chiama GET /v1/balance e mostra all'utente quanto credito è rimasto. Se rivendi l'accesso ai tuoi utenti, questo ti risparmia un sacco di domande di supporto.
  • Le tue rail di sicurezza. Aggiungi un cancello solo per adulti, un pulsante di segnalazione e una regola che blocca qualsiasi richiesta che coinvolga minorenni prima che raggiunga l'API. La piattaforma impone anche quel limite, ma anche la tua app dovrebbe farlo.

Limiti, errori e budget

Una chiave completa consente 8 richieste parallele e 300 richieste al minuto. Una richiesta streaming mantiene uno slot di concorrenza fino alla fine dello streaming, quindi un'app di roleplay con 20 utenti attivi raggiungerà il limite durante i minuti di picco. L'API risponde HTTP 429 con il codice concurrency o rate_limited, e in caso di sovraccarico temporaneo aggiunge Retry-After: 5. Accoda le richieste sul tuo server e riprova dopo quel ritardo.

Le richieste fallite o rifiutate non vengono addebitate, quindi i retry non ti costano nulla. Per il budgeting, un tipico turno di 3.000 token di input e 300 token di output costa $0,00045 + $0,00015 = $0,0006. Il credito è prepagato da $20 e non scade mai. Questo sito accetta cripto, USDT su TRC20 o USDC su Base; la pagina dei prezzi elenca i bonus da $50 in su.

Prossimi passi

Ottieni una chiave e testa con la prova gratuita: la pagina della chiave API offre $0,50 di credito dopo la registrazione, valido per 7 giorni, senza dettagli di pagamento. La chiave di prova consente 2 richieste parallele, sufficienti per un prototipo a singolo utente. La documentazione elenca tutti i parametri, inclusa la chiamata di funzioni se vuoi gestire i tiri di dadi o l'inventario come chiamate di funzioni.

Per una variante stile compagno con un singolo personaggio persistente, vedi l'articolo sull'API del compagno AI. Per un bot di chat all'interno di un server, leggi la guida del bot Discord.

Domande e risposte

Posso chiamare l'API direttamente dal browser?

Puoi, ma esporresti la tua chiave a tutti i visitatori. Tieni la chiave su un server ed esponi solo il tuo endpoint.

Come faccio a impedire al modello di scrivere le azioni del mio personaggio?

Indicalo nel prompt di sistema e, se usi un formato di trascrizione, aggiungi una sequenza di stop. Entrambi funzionano con i parametri passati.

L'app deve memorizzare le conversazioni?

L'API è priva di stato, quindi ogni turno devi reinviare la cronologia. I prompt non vengono usati per l'addestramento.

Qual è il modo più economico per fare un prototipo?

Usa la chiave di prova e una Map in memoria. Passa a un database e a una chiave con credito una volta che il loop funziona.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API