Panduan Awal & Integrasi API

URL Dasar dan Autentikasi

Proyek Heretic menyediakan satu titik akhir yang di-host untuk generasi teks. Gunakan https://api.hereticproject.com/v1 sebagai URL dasar Anda. Autentikasi bergantung pada token pembawa yang diteruskan melalui Authorization header. Buat kunci Anda dengan masuk menggunakan Google atau email di dasbor. Sistem mengeluarkan satu kunci aktif per akun; membuat kunci baru akan membuat kunci sebelumnya tidak valid segera.

Anda hanya membayar token yang dikonsumsi. Kesalahan dan penolakan tidak membebani saldo prabayar Anda. Akun baru menerima kredit percobaan senilai $0,50 yang berlaku selama tujuh hari. Anda mengisi ulang menggunakan USDT (TRC20) atau USDC (Base) dengan jumlah antara $20 dan $500.

Endpoint /v1/chat/completions

Kirim pesan ke endpoint penyelesaian obrolan standar. ID modelnya adalah uncensored. Ini menerima daftar objek pesan dengan peran seperti system, user, atau assistant. Model tidak menolak topik dewasa, fiksi, atau kontroversial yang sah. Ini adalah model bobot terbuka yang disesuaikan untuk jawaban langsung.

Permintaan mengembalikan objek JSON yang berisi teks yang dihasilkan. Jendela konteks mendukung 100,000 token gabungan untuk prompt dan kelengkapan. Output dibatasi hingga 16,000 token per permintaan kecuali Anda menentukan batas yang lebih rendah max_tokens nilai.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Integrasi SDK Python

Gunakan pustaka Python resmi OpenAI dengan URL dasar kustom. Atur api_key ke string API Anda. Konfigurasikan base_url ke titik ke server Proyek Heretic. Ini memungkinkan Anda menggunakan metode yang sudah akrab seperti chat.completions.create() tanpa mengubah struktur kode yang ada secara signifikan.

Instal pustaka melalui pip. Teruskan kredensial Anda langsung ke inisialisasi klien. Pustaka menangani serialisasi secara otomatis. Pendekatan ini berfungsi untuk alur kerja sinkron dan asinkron. Pastikan Anda menangani kesalahan jaringan potensial dengan baik.

Copyfrom openai import OpenAI

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

SDK Node.js bekerja secara identik dengan versi Python. Inisialisasi klien dengan kunci API dan URL dasar yang benar. Anda dapat mengirim permintaan completion menggunakan tanda tangan metode yang sama. Ini memastikan konsistensi di berbagai bagian tumpukan Anda.

Tangani respons secara asinkron. SDK mengalirkan data jika Anda menggunakan metode streaming. Jika tidak, itu mengembalikan respons JSON lengkap. Fleksibilitas ini mendukung pemrosesan batch dan antarmuka waktu nyata. Simpan kunci API Anda dengan aman dalam variabel lingkungan.

Copyimport OpenAI from "openai";

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

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. server mengirim Server-Sent Events (SSE). Setiap chunk berisi pembaruan teks parsial. Ini mengurangi latensi yang dirasakan bagi pengguna akhir. Data penggunaan token muncul di chunk terakhir stream.

Proses setiap objek delta untuk mengakumulasi respons lengkap. Hentikan pendengaran saat aliran ditutup atau terjadi kesalahan. Metode ini ideal untuk antarmuka obrolan. Ini memungkinkan pengguna melihat pemikiran terbentuk secara waktu nyata. Overheadnya minimal dibandingkan dengan respons penuh.

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, Error, dan Konteks

Hormati batas laju untuk menghindari gangguan layanan. Anda diizinkan 300 permintaan per menit per kunci. Koncurrency dibatasi hingga 8 permintaan simultan. Badan permintaan tidak boleh melebihi 8 MB. Melebihi batas ini mengembalikan kode status 429. Tunggu sebentar sebelum mencoba lagi.

Kegagalan autentikasi mengembalikan kesalahan 401. Ini terjadi jika kunci tidak valid atau kedaluwarsa. Kesalahan 402 menunjukkan kredit prabayar yang tidak cukup. Kesalahan pengembalian dana ditangani melalui halaman Dukungan. Kredit tidak pernah kedaluwarsa. Model menolak konten yang melibatkan anak di bawah umur. Semua konten hukum lainnya diterima.