Cara Mengintegrasikan API Uncensored AI

Mengapa Memilih API Uncensored AI?

Sebagian besar penyedia LLM komersial menerapkan filter keamanan agresif yang dapat memblokir penulisan kreatif, roleplay, atau analisis teknis topik kontroversial. API AI tanpa sensor menghilangkan penolakan sewenang-wenang ini, memungkinkan model menjawab berdasarkan data pelatihannya daripada lapisan kebijakan konten. Ini sangat berguna bagi pengembang yang membangun aplikasi yang memerlukan output model mentah tanpa filter pasca-pemrosesan.

Tidak seperti agregator model yang mengarahkan permintaan ke beberapa vendor, layanan ini menyediakan model tunggal yang didedikasikan. Ini menghilangkan ketidakpastian logika pengalihan dan memastikan perilaku yang konsisten di seluruh permintaan. Model ini adalah varian bobot terbuka yang disesuaikan secara khusus untuk meminimalkan penolakan untuk konten dewasa yang sah, penelitian keamanan, dan narasi fiksi.

Namun, 'tanpa sensor' tidak berarti tanpa batas. Layanan ini masih memberlakukan batas tegas pada konten seksual yang melibatkan anak di bawah umur. Untuk sebagian besar kasus penggunaan lainnya, termasuk tema dewasa atau logika yang tidak konvensional, model akan menghasilkan respons. Pendekatan ini sangat ideal bagi pengembang yang ingin memiliki kendali penuh atas strategi konten aplikasi mereka tanpa bergantung pada selera penyedia.

Menyiapkan Lingkungan Anda

Integrasi dimulai dengan mengarahkan SDK yang kompatibel dengan OpenAI Anda ke URL dasar yang benar. Endpoint di-host di https://api.uncensoredai.top/v1. Ini berarti Anda dapat menggunakan pustaka Python atau Node.js resmi OpenAI tanpa menulis ulang logika klien. Anda hanya perlu memperbarui parameter base_url dan menyediakan kunci API Anda.

Layanan ini mendukung jendela konteks 100.000 token, yang jauh lebih besar daripada banyak penawaran standar lainnya. Hal ini memungkinkan penggunaan riwayat prompt yang panjang atau pemrosesan dokumen berukuran besar. Perlu diingat bahwa output maksimum per permintaan adalah 32.000 token. Jika Anda tidak menentukan max_tokens, nilai defaultnya adalah 2.048 token.

• Kompatibilitas SDK: Bekerja dengan klien apa pun yang memahami protokol OpenAI Chat Completions.
• Jendela Konteks: Total 100k token (input + output).
• Output Maks: 32k token per permintaan.

Pastikan variabel lingkungan Anda diatur dengan benar untuk menghindari masalah latensi. API ini dirancang untuk integrasi code-first langsung, sehingga tidak ada antarmuka web yang perlu dipelajari. Anda berinteraksi dengannya murni melalui permintaan HTTP.

Autentikasi dan Header

Autentikasi ditangani melalui header Authorization standar. Anda akan menerima satu kunci API saat mendaftar. Tidak seperti layanan yang memberikan beberapa kunci per akun, platform ini memberlakukan satu kunci aktif per akun. Jika Anda membuat kunci baru, kunci sebelumnya akan segera tidak valid.

Untuk mengautentikasi permintaan, sertakan header: Authorization: Bearer YOUR_API_KEY. Layanan ini juga menyediakan endpoint GET /v1/models, yang mengembalikan informasi model yang tersedia, termasuk ID model uncensored. Ini berguna untuk memverifikasi konektivitas sebelum mengirim payload kompleks.

Batas Laju:

• 300 permintaan per menit per kunci.
• 8 permintaan paralel pada waktu yang sama per kunci.
• Ukuran badan permintaan maksimum 8 MB.

Batas-batas ini cukup longgar untuk sebagian besar aplikasi, tetapi harus dihormati untuk menghindari kesalahan 429. Karena tidak ada paket langganan, batas-batas ini berlaku seragam untuk semua pengguna tanpa memandang saldo kredit.

Mengirim Permintaan Completion Pertama

Permintaan dasar mengikuti format Chat Completions standar. Anda mengirim payload JSON dengan model diatur ke uncensored dan array messages Anda. Layanan ini mengembalikan respons teks. Tidak ada endpoint embeddings, visi, atau audio—ini adalah API teks murni.

Contoh Permintaan:

Berikut ini mendemonstrasikan penyelesaian chat standar. Ganti YOUR_API_KEY dengan kunci aktual Anda.

Copycurl https://api.uncensoredai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Respons akan berisi teks yang dihasilkan di choices[0].message.content. Kesalahan dikembalikan dalam format HTTP standar, memungkinkan Anda menangani percobaan ulang atau kegagalan dengan lancar. Perhatikan bahwa kesalahan tidak mengonsumsi kredit Anda, jadi Anda dapat menguji secara bebas.

Bagi pengembang yang terbiasa dengan OpenAI, pengalamannya identik. Satu-satunya perbedaan adalah URL dasar dan perilaku model terkait filter konten. Konsistensi ini mengurangi kurva pembelajaran untuk tim yang sudah menggunakan alat kompatibel OpenAI.

Menangani Respons Streaming

Streaming didukung melalui Server-Sent Events (SSE). Ini memungkinkan Anda menerima token saat dihasilkan, memberikan pengalaman pengguna yang lebih baik untuk respons panjang. Endpoint streaming sama dengan yang non-streaming; Anda hanya mengatur stream: true dalam permintaan Anda.

Manfaat Streaming:

• Latensi persepsi yang lebih rendah bagi pengguna.
• Kemampuan untuk menampilkan hasil parsial secara real-time.
• Penggunaan memori yang efisien karena token diproses secara inkremental.

Bagian terakhir dari respons streaming mencakup statistik penggunaan token. Ini sangat penting untuk akurasi penagihan, karena Anda dapat melacak tepat berapa banyak token yang dikonsumsi. Kesalahan selama streaming dapat menghasilkan respons parsial, jadi klien Anda harus menangani potongan yang tidak lengkap dengan lancar.

Contoh Kode:

Copyfrom openai import OpenAI

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

Pastikan pustaka klien Anda menangani aliran SSE dengan benar. Sebagian besar SDK modern mengabstraksi ini, tetapi memahami protokol mendasarnya membantu dalam memecahkan masalah koneksi atau kesalahan parsing.

Fitur Lanjutan: Mode JSON dan Alat

API mendukung output terstruktur melalui response_format diatur ke {"type": "json_object"}. Ini memaksa model untuk mengembalikan JSON yang valid, yang penting untuk mengintegrasikan dengan sistem perangkat lunak lain. Fitur ini sangat berguna untuk ekstraksi data atau pembuatan file konfigurasi.

Pemanggilan fungsi juga didukung. Anda dapat menentukan alat dalam permintaan Anda, dan model akan mengembalikan panggilan alat dalam responsnya. Ini memungkinkan alur kerja kompleks di mana LLM dapat memicu tindakan eksternal. Parameter tool_choice memungkinkan Anda memaksa alat tertentu atau membiarkan model memutuskan.

Parameter Kunci:

• temperature: Mengontrol keacakan.
• top_p: Mengontrol keragaman.
• stop: Menentukan urutan berhenti.
• seed: Untuk respons deterministik.

Fitur-fitur ini membuat API cocok untuk aplikasi produksi yang memerlukan data terstruktur yang andal. Meskipun modelnya tanpa sensor, model ini masih mematuhi batasan struktural ketika diminta. Keseimbangan antara kebebasan dan struktur ini adalah keunggulan utama bagi pengembang yang membangun agen kompleks.

Memantau Penggunaan dan Batas

Penggunaan dilacak per kunci API. Dasbor menampilkan saldo kredit Anda saat ini dan riwayat permintaan terbaru. Karena penagihan didasarkan pada penggunaan token secara real-time, Anda dapat memantau biaya Anda secara langsung. Layanan tidak membebankan biaya untuk kesalahan atau penolakan, yang dapat menghemat biaya selama fase pengujian.

Metrik Penggunaan:

• Token input: Dikenakan biaya $0,25 per 1M token.
• Token output: Dikenakan biaya $1,00 per 1M token.
• Kesalahan: Gratis.

Anda dapat mengatur peringatan jika pustaka klien Anda mendukungnya, tetapi pemantauan utama dilakukan melalui dasbor akun. Batas 300 permintaan per menit memastikan penggunaan yang adil untuk semua pengguna. Jika Anda melebihi batas ini, Anda akan menerima kode status 429.

Untuk aplikasi dengan volume tinggi, pertimbangkan untuk menerapkan backoff eksponensial untuk percobaan ulang. Layanan dirancang agar andal, tetapi masalah jaringan atau batas laju dapat terjadi. Melacak penggunaan token Anda membantu Anda membuat anggaran dengan efektif, terutama karena kredit tidak pernah kedaluwarsa.

Mengelola Kredit melalui Kripto

Pembayaran diproses secara eksklusif melalui mata uang kripto. Anda dapat mengisi saldo akun Anda dengan USDT (TRC20) atau USDC (Base). Jumlah pengisian minimum adalah $10, dan maksimum adalah $500. Tidak ada langganan bulanan atau biaya berulang.

Kredit Bonus:

• Pengisian $50: +5% kredit bonus.
• Pengisian $100: +10% kredit bonus.

Kredit tidak pernah kedaluwarsa, sehingga Anda dapat mengisi saldo sekali dan menggunakannya seiring waktu. Ini sangat ideal untuk proyek jangka panjang di mana konsumsi token bervariasi. Tidak adanya biaya pemrosesan kartu kredit membuat kripto menjadi opsi yang hemat biaya untuk pengembang yang sudah memegang stablecoin.

Proses Pembayaran:

Copyimport OpenAI from "openai";

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

Untuk membayar, buat alamat deposit dari dasbor Anda, kirimkan kripto, dan kredit akan ditambahkan secara otomatis. Pengembalian dana tidak tersedia untuk kredit, tetapi kesalahan seperti pengisian ganda akan diperbaiki melalui halaman Dukungan. Model ini mengurangi hambatan bagi pengembang global yang mungkin menghadapi pembatasan perbankan.