Referensi API

URL Dasar dan Autentikasi

Gunakan base URL khusus untuk semua permintaan. Kunci API Anda mengautentikasi melalui Authorization header.

• URL Dasar: https://api.hereticuncensored.com/v1
• ID Model: uncensored

Ambil kunci Anda dari dasbor. Kunci ini valid segera setelah pembuatan.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

Permintaan Pertama

Kirim penyelesaian chat sederhana untuk memverifikasi konektivitas. Model merespons tanpa filter konten standar untuk penggunaan dewasa yang sah.

• Atur model ke uncensored.
• Termukkan messages array.

Periksa respons untuk choices berisi teks yang Anda hasilkan.

Copyfrom openai import OpenAI

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

Integrasi SDK Node

Inisialisasi klien dengan URL dasar dan kunci. Ini memastikan kompatibilitas dengan pustaka OpenAI standar.

• Instal resmi openai paket.
• Lolos baseURL dan apiKey selama inisialisasi.

Panggil chat.completions.create() dengan prompt Anda. Struktur respons mencerminkan format API standar.

Copyimport OpenAI from "openai";

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

Respons Streaming

Aktifkan pengiriman token real-time dengan mengatur stream ke true. Ini mengurangi latensi yang dirasakan untuk output panjang.

• Dengarkan delta bagian.
• Gabungkan delta untuk menyusun ulang respons lengkap.

Metadata penggunaan token muncul dalam potongan terakhir. Ini sangat ideal untuk antarmuka obrolan yang memerlukan umpan balik instan.

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)

Batas Laju dan Konteks

API mendukung jendela konteks 100.000 token. Anda dapat mengirim hingga 300 permintaan per menit per kunci.

• Permintaan simultan maks: 8
• Token output maksimal: 16,000 (default 2,048)

Melebihi batas memicu kesalahan 429. Kelola konkurensi untuk mempertahankan throughput yang konsisten untuk beban kerja volume tinggi.

Penanganan Kesalahan dan Kode

Tangani kesalahan dengan baik untuk menjaga stabilitas aplikasi. Kode umum termasuk 401 untuk kunci tidak valid dan 402 untuk kredit tidak cukup.

• 429 menunjukkan kelelahan batas kecepatan.
• 400 menandakan body permintaan yang tidak valid.

Pengembalian dana tidak diterbitkan untuk token yang dikonsumsi. Periksa saldo Anda secara teratur untuk menghindari gangguan layanan.