Dokumentasi API

Autentikasi dan URL Dasar

Gunakan kunci API Anda dengan setiap permintaan. URL dasarnya adalah https://api.nsfwroleplayapi.com/v1. Setel Authorization header ke Bearer YOUR_API_KEY. Kunci Anda memberikan akses ke endpoint chat-completions.

Endpoint Chat Completions

Kirimkan prompt Anda ke POST /v1/chat/completions. Tentukan model "uncensored" dalam tubuh permintaan. API mengembalikan teks yang dihasilkan berdasarkan input Anda.

context_window memungkinkan total 100.000 token. Ini mencakup prompt dan kelengkapan. Anda dapat mengatur max_tokens untuk membatasi output.

Copycurl https://api.nsfwroleplayapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Confirm monthly credit balance is active"}]
  }'

Streaming dan Penggunaan Token

Aktifkan streaming dengan mengatur stream: true. API mengirim Server-Sent Events (SSE) saat token dihasilkan. Terima pembaruan teks real-time di aplikasi Anda. Ini meningkatkan pengalaman pengguna untuk respons panjang.

Bagian terakhir berisi total penggunaan token. Lacak konsumsi kredit prabayar Anda secara akurat. Kesalahan tidak mengonsumsi kredit.

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

Parameter: Suhu, Top P, dan Mode JSON

Kendalikan generasi dengan temperature dan top_p. Sesuaikan ini untuk mengubah kreativitas atau determinisme. Gunakan response_format dengan {"type": "json_object"} untuk data terstruktur. Ini memastikan format output yang konsisten.

Anda juga dapat mengatur seed untuk hasil yang dapat direproduksi. Tetapkan stop urutan untuk menghentikan generasi lebih awal. Parameter ini memberikan kontrol presisi.

Copyfrom openai import OpenAI

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

Batas Laju dan Konvergensi

Setiap kunci API mendukung 300 permintaan per menit. Anda dapat memiliki 8 permintaan konkuren secara simultan. Batas ukuran badan permintaan adalah 8 MB. Melebihi batas ini akan mengembalikan error 429.

Anda dapat membuat kunci baru untuk menggantikan kunci lama. Hanya satu kunci aktif yang diperbolehkan per akun. Kelola kunci Anda untuk mempertahankan akses. Ini memastikan kinerja yang stabil.

Copyimport OpenAI from "openai";

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

Penanganan Kesalahan dan Penolakan

Tangani kesalahan dengan memeriksa kode status HTTP. Kesalahan 401 berarti kunci API Anda tidak valid. Kesalahan 402 menunjukkan kredit prabayar tidak cukup. Segarkan saldo Anda melalui dasbor.

Kesalahan 429 menandakan habisnya batas laju. Tunggu sebelum mencoba lagi. Model menolak permintaan yang melibatkan anak di bawah umur. Semua konten dewasa hukum lainnya diperbolehkan. Periksa tubuh respons untuk detailnya.