URL Dasar dan Autentikasi
Terhubung ke API menggunakan URL dasar yang disediakan dan kunci API Anda. Titik akhir ini kompatibel dengan SDK OpenAI standar hanya dengan memperbarui konfigurasi. Anda menerima satu kunci aktif per akun, yang Anda buat melalui Google atau email saat pendaftaran. Kunci tersebut mengautentikasi setiap permintaan yang Anda kirimkan ke layanan.
curl https://api.hubuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Generate a JSON object with user id and role"}]
}'Jaga kunci Anda tetap aman. Jika Anda menghasilkan kunci baru, kunci sebelumnya menjadi tidak berlaku segera. Ini memastikan Anda selalu mengontrol akses ke kredit prabayar Anda tanpa izin yang tertinggal.
Endpoint Chat Completions
Kirimkan data prompt Anda ke endpoint penyelesaian obrolan untuk generasi teks. Ini adalah antarmuka utama untuk aplikasi Anda, menangani semua input dan output teks. Anda harus menentukan model sebagai 'uncensored' untuk memastikan perilaku yang konsisten. API memproses permintaan Anda dan mengembalikan respons teks yang dihasilkan.
from openai import OpenAI
client = OpenAI(base_url="https://api.hubuncensored.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)Kesalahan seperti 401 menunjukkan kunci tidak valid, sedangkan 402 berarti Anda membutuhkan lebih banyak kredit. Permintaan dibebankan berdasarkan penggunaan token aktual, sehingga kesalahan tidak menguras saldo Anda.
Respons Streaming melalui SSE
Terima token secara real-time menggunakan Server-Sent Events (SSE). Metode ini mengurangi latensi persepsi untuk output panjang dengan mengirimkan data saat dihasilkan. Anda dapat mengurai potongan terakhir untuk mendapatkan statistik penggunaan token yang akurat untuk penagihan. Streaming sangat ideal untuk antarmuka yang berorientasi pengguna di mana umpan balik segera sangat penting.
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)Jendela konteks memungkinkan total 100.000 token, termasuk prompt dan completion. Streaming tidak mengubah batas token dasar atau struktur harga.
Pemanggilan Fungsi dan Mode JSON
Gunakan pemanggilan fungsi untuk mengintegrasikan output terstruktur ke dalam alur kerja Anda. Tentukan alat dan tool_choice untuk memandu format respons model. Anda juga dapat memaksakan mode JSON ketat menggunakan parameter response_format untuk parsing yang andal. Ini memastikan aplikasi Anda menerima data dalam struktur persis yang Anda tentukan.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.hubuncensored.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);Fitur ini bekerja dalam model tidak disensor tunggal. Tidak ada pengalihan model atau pilihan antara vendor yang berbeda. Anda mengandalkan satu model open-weight yang disesuaikan untuk konten tanpa batasan.
Parameter: Suhu, Top P, dan Stop
Kendalikan perilaku generasi dengan parameter standar seperti suhu dan top_p. Sesuaikan nilai-nilai ini untuk menyeimbangkan kreativitas dan determinisme dalam output Anda. Parameter stop memungkinkan Anda menghentikan generasi pada urutan tertentu. Anda juga dapat mengatur presence_penalty dan frequency_penalty untuk menyempurnakan gaya output.
Atur max_tokens ke 16.000 untuk respons panjang. Jika Anda melewatkan max_tokens, defaultnya adalah 2.048 token per permintaan. Pengaturan ini memberi Anda kontrol presisi atas proses generasi.
Batas, Error, dan Jendela Konteks
Pantau penggunaan Anda terhadap batas laju ketat untuk memastikan operasi yang lancar. Anda diizinkan 300 permintaan per menit dan 8 permintaan bersamaan per kunci. Ukuran tubuh permintaan maksimum adalah 8 MB. Melebihi batas ini mengembalikan error batas laju 429. Memahami kendala ini membantu Anda merancang logika retry yang kuat.
Jendela konteks mendukung total 100.000 token. Ini mencakup prompt input dan completion yang dihasilkan. Rencanakan penggunaan token Anda dengan tepat untuk menghindari pemotongan atau error.
