Dokumentasi API

Autentikasi dan URL Dasar

API memerlukan token bearer untuk setiap permintaan. Buat kunci Anda di halaman Dapatkan Kunci API dengan masuk menggunakan Google atau kata sandi email. Kunci muncul segera tanpa verifikasi telepon. Gunakan URL dasar https://api.uncensoredaigithub.com/v1 dengan SDK OpenAI resmi dengan memperbarui base_url dan api_key nilai. Pengaturan ini berfungsi dengan klien kompatibel OpenAI mana pun.

Endpoint: https://api.uncensoredaigithub.com/v1

Header Auth: Authorization: Bearer YOUR_API_KEY

Setiap akun mendukung satu kunci aktif. Menerbitkan kunci baru secara otomatis membuat kunci sebelumnya tidak berlaku. Ini mencegah pergeseran token saat Anda melakukan rotasi kredensial di berbagai lingkungan.

Endpoint Chat Completions

Kirim permintaan teks ke /v1/chat/completions endpoint menggunakan ID model uncensored. API menerima pesan obrolan standar dan mengembalikan respons teks tanpa filter konten untuk penggunaan dewasa yang sah. Anda dapat mengonfigurasi parameter seperti temperature, top_p, dan stop untuk mengontrol kreativitas dan panjang output.

Jendela konteks memungkinkan hingga 100.000 token untuk prompt dan penyelesaian gabungan. Atur max_tokens untuk mengontrol output, dengan nilai default 2.048 token jika dihilangkan. Kesalahan dan penolakan tidak mengonsumsi kredit, sehingga Anda dapat menguji dengan aman.

Respons Streaming dan Penggunaan

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) berisi potongan teks parsial. Data penggunaan token hanya muncul di potongan terakhir aliran. Ini memungkinkan rendering respons secara real-time sambil melacak konsumsi secara akurat.

Streaming sangat ideal untuk aplikasi roleplay atau generasi konten panjang. Anda dapat mem-parsing stream SSE untuk memperbarui UI secara inkremental. API memastikan bahwa metrik penggunaan tetap akurat bahkan jika koneksi terputus lebih awal.

Pemanggilan Fungsi dan Alat

Dukung pemanggilan fungsi dengan menyediakan tools array dalam permintaan. Model dapat mengembalikan panggilan alat terstruktur dengan argumen. Gunakan tool_choice untuk memaksakan perilaku spesifik, seperti eksekusi fungsi otomatis. Fitur ini memungkinkan integrasi dengan layanan eksternal atau logika kustom.

Tentukan fungsi dengan nama, deskripsi, dan skema parameter. API mengembalikan nama fungsi dan argumen dalam respons. Parse argumen ini untuk mengeksekusi kode kustom Anda. Kemampuan ini membuat API LLM uncensored cocok untuk alur kerja agen kompleks.

Mode JSON dan Parameter

Paksa output terstruktur dengan mengatur response_format ke {"type": "json_object"}. Model akan mengembalikan JSON alih-alih teks biasa. Ini berguna untuk ekstraksi data atau generasi konfigurasi. Gabungkan ini dengan pemanggilan fungsi untuk integrasi API yang kuat.

Parameter pendukung lainnya termasuk seed untuk output deterministik, presence_penalty, dan frequency_penalty. Gunakan seed untuk mereproduksi respons spesifik untuk debugging. Sesuaikan penalti untuk mengurangi pengulangan atau mendorong kosakata yang lebih beragam dalam output Anda.

Penanganan Kesalahan dan Batasan

API menerapkan batas laju 300 permintaan per menit dan 8 permintaan simultan per kunci. Badan permintaan tidak boleh melebihi 8 MB. Jika Anda melebihi batas ini, Anda akan menerima kode status 429. Kegagalan autentikasi mengembalikan error 401. Kredit yang tidak cukup memicu error 402.

Saldo dibebankan berdasarkan penggunaan token aktual. Saldo prabayar tidak pernah kedaluwarsa, sehingga Anda tidak perlu khawatir tentang perpanjangan bulanan. Gunakan halaman Dukungan untuk menyelesaikan masalah seperti pembebanan ganda.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)