Diperbarui
Aplikasi Roleplay AI Tanpa Filter: Bangun Dengan API
API pacar AI menyediakan antarmuka khusus untuk aplikasi obrolan yang mensimulasikan interaksi romantis atau seperti teman pendamping menggunakan model bahasa besar. Panduan ini membandingkan pendekatan teknis, dengan fokus pada model tanpa sensor yang menangani konteks roleplay tanpa penolakan konten standar.

Arsitektur dalam satu gambar
Browser mengirim pesan pengguna ke server Anda. Server Anda menambahkan persona dan riwayat terbaru, memanggil model dengan stream: true, dan meneruskan setiap bagian kembali. Tidak diperlukan lagi.
- Browser: kotak teks dan div yang membesar saat token tiba.
- Server Anda: menyimpan kunci API, membangun daftar pesan, menegakkan batas per pengguna Anda sendiri.
- Model API:
POST /v1/chat/completionsdihttps://api.nofilterai.top/v1dengan modeluncensored. - Penyimpanan: tabel atau file pesan per percakapan. SQLite cukup untuk memulai.
Model adalah satu model bobot terbuka, disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Hanya teks. Jika Anda ingin seni karakter atau suara, tambahkan layanan lain sendiri.
Desain prompt sistem
Untuk roleplay, prompt sistem melakukan sebagian besar pekerjaan. Pisahkan menjadi tiga blok pendek agar Anda dapat mengganti masing-masing secara independen: dunia, karakter, dan aturan format.
{
"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."
}
Gabungkan menjadi satu pesan sistem saat permintaan dibuat. Menyimpannya secara terpisah memungkinkan pengguna memilih dunia dan karakter secara independen, yang merupakan sebagian besar kebutuhan aplikasi roleplay. Karena fiksi dewasa diizinkan untuk penggunaan dewasa yang sah, sebutkan sekali dalam syarat layanan Anda sendiri dan tambahkan gerbang usia. Satu hal yang tidak akan dihasilkan API adalah konten seksual yang melibatkan anak di bawah umur, dan aplikasi Anda sebaiknya tidak mencobanya.
Backend streaming
Rute Express ini menerima ID percakapan dan pesan, memuat riwayat, dan mengalirkan stream ke browser sebagai peristiwa yang dikirim server. Ini menggunakan paket openai resmi.
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);
Bagian terakhir dari stream membawa penggunaan, yang dapat Anda log untuk melihat berapa biaya setiap percakapan. Di produksi, ganti Map dengan database dan tambahkan penanganan kesalahan di sekitar panggilan tersebut.
Pangkas riwayat di dalam jendela 100k
Jendela konteks adalah 100.000 token untuk prompt plus penyelesaian. Sesi roleplay tumbuh perlahan, tetapi mereka tumbuh. Fungsi pemangkasan yang bekerja berdasarkan ukuran menghindari kejutan. Perkiraan kasar 4 karakter per token cukup baik untuk penganggaran.
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 karakter adalah sekitar 30.000 token, jauh di bawah batas, dan ini menjaga setiap panggilan murah. Naikkan hanya jika cerita Anda membutuhkan ingatan panjang. Ingat aturan biaya: setiap giliran mengirim ulang riwayat yang disimpan sebagai input pada $0,15 per 1 juta token, jadi prompt 30.000 token biaya 30.000 / 1.000.000 x $0,15 = $0,0045 per giliran sebelum balasan.
Klien browser
Halaman membaca stream SSE dengan fetch dan menambahkan teks saat tiba. Karena permintaan adalah POST, EventSource tidak cocok, jadi parse stream secara manual.
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));
}
}
}
}Fitur yang membuatnya terasa seperti aplikasi
- Regenerasi dan edit. Simpan ID pesan. Regenerasi berarti menghapus pesan asisten terakhir dan memanggil API lagi dengan riwayat yang sama. Mengedit berarti menulis ulang pesan yang disimpan sebelum panggilan berikutnya.
- Pengaturan per karakter. Simpan
temperature,top_pdan penalti dengan setiap karakter. Karakter yang lebih tenang seperti 0,7, yang kacau seperti 1,0. Lulusseedsaat Anda ingin menjalankan uji coba yang dapat direproduksi. - Tampilan biaya. Baca header respons
X-Balance-USDatau panggilGET /v1/balancedan tampilkan kepada pengguna berapa banyak kredit yang tersisa. Jika Anda menjual kembali akses ke pengguna Anda sendiri, ini menghemat banyak pertanyaan dukungan. - Jalur keselamatan yang Anda miliki. Tambahkan gerbang hanya dewasa, tombol laporan, dan aturan yang memblokir permintaan apa pun yang melibatkan anak di bawah umur sebelum mencapai API. Platform menegakkan batas tersebut juga, tetapi aplikasi Anda juga harus melakukannya.
Batas, kesalahan, dan anggaran
Kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit. Permintaan yang dialirkan memegang slot konkurensi hingga stream berakhir, jadi aplikasi roleplay dengan 20 pengguna aktif akan mencapai batas selama menit sibuk. API menjawab HTTP 429 dengan kode concurrency atau rate_limited, dan saat kelebihan beban sementara menambahkan Retry-After: 5. Antrikan permintaan di server Anda dan coba lagi setelah penundaan itu.
Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga percobaan ulang tidak membebani Anda. Untuk penganggaran, putaran khas dengan 3.000 token input dan 300 token output berharga $0,00045 + $0,00015 = $0,0006. Saldo prabayar mulai dari $20 dan tidak pernah kedaluwarsa. Situs ini menerima kripto, USDT pada TRC20 atau USDC pada Base; halaman harga mencantumkan bonus mulai dari $50 ke atas.
Langkah selanjutnya
Dapatkan kunci dan uji dengan kredit uji coba gratis: halaman kunci API menawarkan $0,50 kredit setelah masuk, berlaku selama 7 hari, tanpa memerlukan detail pembayaran. Kunci uji coba mengizinkan 2 permintaan paralel, cukup untuk prototipe pengguna tunggal. dokumentasi mencantumkan setiap parameter, termasuk pemanggilan fungsi jika Anda ingin dadu atau inventaris ditangani sebagai panggilan fungsi.
Untuk varian gaya pendamping dengan satu karakter yang persisten, lihat artikel API pendamping AI. Untuk bot obrolan di dalam server, baca panduan bot Discord.
Panduan lainnya
Tanya jawab
Bisakah Anda memanggil API langsung dari browser?
Anda bisa, tetapi Anda akan mengekspos kunci Anda ke setiap pengunjung. Simpan kunci di server dan ekspos hanya rute Anda sendiri.
Bagaimana cara menghentikan model menulis tindakan karakter saya?
Nyatakan dalam prompt sistem dan, jika Anda menggunakan format transkrip, tambahkan urutan berhenti. Keduanya bekerja dengan parameter pass-through.
Apakah aplikasi perlu menyimpan percakapan?
API itu sendiri stateless, jadi Anda mengirim ulang riwayat setiap giliran. Prompt tidak digunakan untuk pelatihan.
Apa cara termurah untuk membuat prototipe?
Gunakan kunci uji coba dan Map di memori. Pindah ke database dan kunci berbayar setelah loop berfungsi.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.
Dapatkan kunci API