id ▾
Dapatkan kunci Anda

uncensoredroleplayai.com/Dokumentasi

Panduan Awal API AI Tanpa Sensor

Dapatkan instance AI roleplay tanpa sensor yang berjalan dalam hitungan menit dengan API yang kompatibel dengan OpenAI kami. Gunakan SDK standar untuk mengirim teks dan menerima respons konteks panjang tanpa filter konten.

Prasyarat dan penyiapan URL dasar

Mulailah dengan mendaftarkan akun melalui Google atau email di halaman kunci. Kunci API Anda muncul segera dan berfungsi sebagai satu-satunya kredensial untuk semua permintaan. URL dasar layanan adalah https://api.uncensoredroleplayai.com/v1, yang kompatibel dengan klien apa pun yang kompatibel dengan OpenAI.

Konfigurasikan variabel lingkungan atau klien SDK Anda untuk mengarah ke URL ini. Titik akhir tunggal ini menangani semua penyelesaian teks. Anda tidak perlu mengelola pengalihan model atau memilih dari beberapa vendor. Pengidentifikasi modelnya selalu uncensored, model open-weight yang disesuaikan untuk konten dewasa dan fiksi.

Autentikasi dengan kunci API

Termukkan kunci API Anda di Authorization header sebagai token Bearer. Setiap permintaan harus menyertakan header ini untuk mengotentikasi identitas Anda. Jika kunci hilang atau tidak valid, server akan mengembalikan error 401 Unauthorized. Periksa dasbor akun Anda jika Anda mencurigai kunci telah dicabut.

Setiap akun memiliki satu kunci aktif pada satu waktu. Pembuatan kunci baru menggantikan kunci lama secara langsung. Tidak ada batasan jumlah kunci yang dapat Anda buat secara historis, tetapi hanya kunci saat ini yang berfungsi. Gunakan kunci tunggal ini di semua layanan Anda.

Mengirimkan penyelesaian chat pertama Anda

Buat permintaan POST ke /v1/chat/completions endpoint. endpoint. Masukkan nama model uncensored dan riwayat percakapan Anda di messages array. Sistem mengembalikan respons teks tanpa filter untuk topik dewasa yang sah.

  • Atur model menjadi uncensored.
  • Sertakan prompt sistem Anda untuk menentukan persona roleplay.
  • Kirim pesan pengguna untuk mendorong narasi maju.

Verifikasi struktur respons berisi teks yang dihasilkan. Ini mengkonfirmasi bahwa integrasi Anda berfungsi dengan benar dengan API LLM uncensored.

Menangani respons streaming

Aktifkan streaming dengan mengatur stream ke true dalam permintaan Anda. API mengirimkan potongan melalui Server-Sent Events (SSE). Setiap potongan berisi teks parsial dan metadata. Proses potongan-potongan ini secara waktu nyata untuk menampilkan respons saat dihasilkan.

Detail penggunaan token muncul di potongan terakhir. Ini memungkinkan Anda melacak biaya secara akurat tanpa menunggu seluruh respons. Streaming sangat ideal untuk bot roleplay di mana latensi sangat penting. Gunakan SDK Node untuk penanganan peristiwa ini dengan mudah.

Mengkonfigurasi parameter untuk roleplay

Sesuaikan parameter seperti temperature dan top_p untuk mengontrol kreativitas. Suhu yang lebih tinggi menghasilkan output yang lebih beragam dan tidak terduga. Gunakan stop urutan untuk mengakhiri respons pada frasa tertentu. Mode JSON tersedia melalui response_format untuk data terstruktur.

Atur max_tokens untuk mengontrol panjang output. Nilai defaultnya adalah 2.048 token, tetapi Anda dapat meminta hingga 16.000. Jendela konteks mendukung total 100.000 token. Ini memungkinkan kontinuitas teks panjang tanpa kehilangan konteks. Sesuaikan pengaturan ini untuk kasus penggunaan spesifik Anda.

Memahami penggunaan dan harga token

Harga transparan: $0.15 per satu juta token input dan $0.50 per satu juta token output. Kesalahan dan penolakan gratis. Kredit dibayar di muka dan tidak pernah kedaluwarsa. Isi ulang melalui kripto dengan USDT (TRC20) atau USDC (Base).

Batas termasuk 300 permintaan per menit dan 8 permintaan simultan per kunci. Ukuran badan permintaan dibatasi hingga 8 MB. Jika Anda kehabisan kredit, Anda menerima error 402 Pembayaran Diperlukan. Pantau penggunaan Anda melalui dasbor untuk menghindari gangguan.

cURL

curl https://api.uncensoredroleplayai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
  }'

Python

from openai import OpenAI

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

import OpenAI from "openai";

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

stream = 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)
01

Tanya Jawab Teknis

Apa batas konteks AI roleplay tanpa sensor?

Jendela konteks mendukung 100.000 token baik untuk prompt maupun completion. Anda dapat menghasilkan hingga 16.000 token per permintaan. Ini memungkinkan cerita berbentuk panjang tanpa kehilangan konteks. Penolakan untuk konten seksual ringan masih berlaku.

Bagaimana cara menangani error autentikasi?

Kesalahan 401 menunjukkan kunci API tidak valid atau hilang. Periksa dasbor akun Anda untuk memastikan kunci tersebut aktif. Buat kunci baru jika kunci lama telah dicabut. Setiap akun hanya memiliki satu kunci aktif pada satu waktu.

Apa yang terjadi jika saya melebihi batas laju?

Anda akan menerima error 429 Too Many Requests. Batasnya adalah 300 permintaan per menit dan 8 permintaan simultan. Tunggu beberapa detik sebelum mencoba lagi. Pantau penggunaan Anda agar tetap dalam batas.

Ambil kunci API Anda

Daftar, salin token, perbarui endpoint. Itu adalah konfigurasi lengkapnya.