Dokumentasi API untuk Chat Completions Uncensored

Memulai: Hubungkan di Python atau JavaScript

Terhubung ke API dengan memperbarui URL dasar Anda dan mengatur kunci API Anda. Endpoint ini menerima permintaan chat-completion standar dan mengembalikan teks. Anda tidak perlu menginstal pustaka khusus jika Anda menggunakan SDK OpenAI resmi, karena antarmuka cocok dengan spesifikasi mereka secara tepat.

Mulai dengan permintaan HTTP sederhana untuk memverifikasi konektivitas. Gunakan perintah curl di bawah ini untuk mengirim prompt dasar ke uncensored model. Ganti YOUR_API_KEY dengan kunci yang dihasilkan di dasbor Anda.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Untuk pengembang Python, prosesnya hampir identik. Inisialisasi klien dengan kunci Anda dan base URL yang benar. Ini memastikan semua permintaan dialihkan melalui server tanpa sensor kami sambil mempertahankan kompatibilitas dengan alat yang ada.

Copyfrom openai import OpenAI

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

Pengguna JavaScript dapat mencapai hasil yang sama menggunakan SDK Node. Atur baseURL properti ke endpoint kami. Pendekatan ini memungkinkan Anda mengintegrasikan API ke dalam server web atau layanan backend dengan perubahan kode yang minimal.

Copyimport OpenAI from "openai";

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

Autentikasi dan manajemen kunci API

Autentikasi mengandalkan satu kunci API yang dikirim dalam header. Kirimkan kunci ini di Authorization header untuk setiap permintaan. Jika kunci hilang atau tidak valid, API mengembalikan kesalahan 401 segera. Ini memastikan akses aman ke kredit pra-dibayar Anda.

Hasilkan kunci Anda di dasbor. Kunci ditampilkan sekali saat dibuat. Simpan dengan aman di variabel lingkungan Anda. Jangan bagikan secara publik. Setiap akun mendukung satu kunci aktif pada satu waktu. Membuat kunci baru akan membatalkan kunci sebelumnya secara instan.

Gunakan kunci dalam permintaan Anda seperti ini: Authorization: Bearer YOUR_API_KEY. Format header standar ini bekerja dengan semua SDK utama. Simpan kunci Anda agar mudah diakses untuk iterasi cepat selama pengembangan.

Parameter endpoint Chat Completions

Kirim permintaan ke /v1/chat/completions endpoint. endpoint. Sertakan array pesan Anda dan atur model ke uncensored. Anda dapat menyesuaikan parameter seperti temperature dan top_p untuk mengontrol kreativitas. Nilai yang lebih tinggi menghasilkan respons yang lebih bervariasi.

Atur max_tokens untuk membatasi panjang output. Default adalah 2.048 token jika tidak ditentukan. Model mendukung jendela konteks 100.000 token untuk prompt ditambah penyelesaian. Ini memungkinkan percakapan panjang tanpa pemotongan. Sesuaikan presence_penalty dan frequency_penalty untuk mengurangi pengulangan dalam skenario role-play.

Gunakan stop parameter untuk menghentikan generasi pada frasa tertentu. Ini membantu menegakkan struktur dialog. The seed parameter memastikan output yang dapat direproduksi untuk pengujian. Alat-alat ini memberikan kontrol presisi atas perilaku model.

Responsi streaming dan data penggunaan

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan potongan teks begitu potongan tersebut dihasilkan. Ini mengurangi latensi yang dirasakan bagi pengguna akhir. Setiap potongan mencakup teks parsial dan metadata.

Data penggunaan muncul di bagian akhir. Ini mencakup jumlah token input dan output. Periksa usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Tangani pengakhiran stream dengan hati-hati. Pastikan Anda memproses semua chunk sebelum menutup koneksi. Chunk terakhir berisi statistik penggunaan lengkap. Data ini penting untuk memantau biaya dan kinerja di aplikasi produksi.

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)

Penanganan kesalahan dan batasan laju

API menerapkan batas 300 permintaan per menit per kunci. Permintaan simultan dibatasi hingga delapan per kunci. Body permintaan tidak boleh melebihi 8 MB. Melebihi batas ini akan mengembalikan error 429. Terapkan exponential backoff untuk menangani lonjakan sementara.

Kesalahan umum termasuk 401 untuk kunci tidak valid dan 402 untuk kredit tidak cukup. Respons 402 menunjukkan saldo prabayar Anda telah habis. Tambah saldo akun Anda untuk melanjutkan layanan. Kesalahan tidak mengonsumsi token, sehingga mencoba lagi setelah memperbaiki masalah adalah gratis.

Periksa body respons untuk pesan kesalahan terperinci. API mengembalikan objek JSON dengan jenis kesalahan dan pesan. Gunakan informasi ini untuk memperbaiki masalah dengan cepat. Penanganan kesalahan yang tepat memastikan pengalaman yang lancar untuk pengguna Anda selama periode lalu lintas tinggi.

Panduan mode JSON dan pemanggilan fungsi

Gunakan mode JSON dengan mengatur response_format ke {"type": "json_object"}. Ini memaksa model untuk menghasilkan JSON yang valid. Sangat ideal untuk ekstraksi data terstruktur atau respons API. Pastikan prompt Anda secara jelas mendeskripsikan skema yang diinginkan.

Pemanggilan fungsi memungkinkan model memanggil alat. Tentukan alat dalam body permintaan. Model mengembalikan panggilan alat saat diperlukan. Tangani panggilan ini dalam logika aplikasi Anda. Ini memungkinkan alur kerja multi-langkah yang kompleks.

Gabungkan mode JSON dengan pemanggilan fungsi untuk integrasi yang kuat. Validasi output JSON di sisi klien. Gunakan tool_choice parameter untuk mengontrol kapan fungsi dipanggil. Fleksibilitas ini mendukung berbagai arsitektur aplikasi. Pastikan alat Anda terdefinisi dengan baik untuk kinerja optimal.

Detail model dan batas jendela konteks

The uncensored model mendukung jendela konteks 100.000 token. Ini mencakup prompt input dan kelengkapan output. Output maksimal adalah 16.000 token per permintaan. Ini memungkinkan skenario roleplay yang ekstensif tanpa terputus di tengah kalimat.

Model ini bobot terbuka dan disesuaikan untuk konten tanpa batasan. Model ini tidak menolak topik dewasa yang sah. Ini bukan GPT, Claude, atau model vendor lain. Permintaan diproses di server khusus kami. Ini memastikan kinerja yang konsisten dan latensi rendah.

Pantau penggunaan konteks agar tetap dalam batas. API melacak penggunaan token secara akurat. Kesalahan dan penolakan tidak mengonsumsi token. Model penagihan transparan ini membantu Anda memprediksi biaya. Rencanakan jendela konteks Anda untuk memaksimalkan nilai.