Dokumentasi API

Autentikasi dan URL Dasar

API memerlukan satu kunci API untuk autentikasi. Anda menerima kunci ini segera setelah mendaftar dengan Google atau alamat email. Lintaskan dalam Authorization header sebagai token Bearer. URL dasar adalah https://api.topuncensored.com/v1. URL ini berfungsi dengan SDK atau pustaka klien kompatibel OpenAI apa pun.

• Gunakan header: Authorization: Bearer YOUR_API_KEY
• Atur URL dasar klien Anda ke endpoint yang disediakan.

Konfigurasi ini memastikan Anda dapat mengganti pustaka tanpa mengubah logika inti Anda.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Chat Completions

Kirim prompt teks ke /v1/chat/completions endpoint. endpoint. ID model adalah uncensored. Endpoint ini menangani format obrolan standar dengan pesan. Endpoint ini mengembalikan respons teks secara langsung. Tidak ada lapisan tambahan atau pembungkus. Anda mengontrol jendela konteks 100.000 token. Permintaan di bawah 8 MB bekerja dengan andal. Gunakan ini untuk generasi teks langsung.

Strukturkan permintaan Anda dengan prompt sistem dan pesan pengguna. Model merespons tanpa memfilter konten dewasa yang sah. Kesalahan seperti kunci yang hilang mengembalikan 401. Habis kredit? Anda mendapatkan error 402. Ini adalah sinyal yang jelas.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true. Anda menerima potongan teks saat teks tersebut dihasilkan. Ini mengurangi latensi yang dirasakan untuk output panjang. Potongan terakhir mencakup data penggunaan token. Gunakan ini untuk tampilan real-time atau rendering progresif. Ini efisien untuk aplikasi dengan volume tinggi.

Parse setiap potongan untuk membangun respons akhir Anda. Metode ini menangani output besar dengan baik. API mendukung Server-Sent Events standar. Ini adalah pendekatan yang direkomendasikan untuk aplikasi interaktif.

Copyfrom openai import OpenAI

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

Pemanggilan Alat dan Mode JSON

Gunakan pemanggilan fungsi untuk interaksi terstruktur. Tentukan alat dalam permintaan Anda. Model mengembalikan argumen terstruktur. Tetapkan response_format ke {"type": "json_object"} untuk output JSON ketat. Ini memastikan format data yang dapat diprediksi. Gabungkan fitur-fitur ini untuk integrasi yang kuat. Anda mendapatkan kontrol presisi atas struktur output.

Pemanggilan alat bekerja dengan skema OpenAI standar. Mode JSON memaksa JSON valid. Gunakan ini untuk integrasi API atau ekstraksi data. Fleksibilitas ini mendukung alur kerja kompleks.

Copyimport OpenAI from "openai";

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

Parameter dan Batas

Sesuaikan temperature, top_p, dan stop urutan. Setel max_tokens ke 16.000. Default adalah 2.048 jika dihilangkan. Kontrol pengulangan dengan presence_penalty dan frequency_penalty. Gunakan seed untuk output deterministik. Parameter-parameter ini menyesuaikan kualitas generasi. Anda memiliki kendali penuh atas gaya output.

Batas laju adalah 300 permintaan per menit. Permintaan simultan dibatasi hingga 8. Batas-batas ini memastikan kinerja stabil. Pantau penggunaan Anda melalui dasbor. Sesuaikan parameter untuk mengoptimalkan kasus penggunaan spesifik Anda.

Error dan Jendela Konteks

Tangani kesalahan dengan baik. 401 berarti kunci tidak valid. 402 menunjukkan kredit tidak cukup. 429 menandakan batas laju. Jendela konteks adalah 100.000 token total. Output maksimal 16.000 token. Kelola token Anda dengan bijak. Kesalahan tidak mengonsumsi kredit. Ini menghemat uang selama debugging. Gunakan bagian terakhir untuk statistik penggunaan.

Lacak penggunaan token Anda. Hindari mencapai batas laju. Coba lagi dengan backoff eksponensial. Ini memastikan pengoperasian yang andal. API dirancang untuk ketangguhan. Tangani kesalahan sebagai bagian dari aliran normal.

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)