Permulaan Pantas API & Integrasi

URL Asas dan Pengesahan

Projek Heretic menyediakan satu titik akhir yang dihoskan untuk penjanaan teks. Gunakan https://api.hereticproject.com/v1 sebagai URL asas anda. Pengesahan bergantung pada token pembawa yang dihantar melalui Authorization header. Cipta kunci anda dengan log masuk menggunakan Google atau e-mel di papan pemuka. Sistem mengeluarkan satu kunci aktif per akaun; menjana kunci baharu akan menamatkan kelayakan kunci sebelumnya serta-merta.

Anda hanya membayar untuk token yang digunakan. Ralat dan penolakan tidak mengenakan caj pada kredit pra-bayar anda. Akaun baharu menerima $0.50 kredit percubaan yang sah selama 7 hari. Anda menambah baki menggunakan USDT (TRC20) atau USDC (Base) dalam jumlah antara $20 dan $500.

Hujung sambungan /v1/chat/completions

Hantar mesej ke hujung titik penyelesaian semakan piawai. ID model ialah uncensored. Ia menerima senarai objek mesej dengan peranan seperti system, user, atau assistant. Model ini tidak menolak topik dewasa yang sah, fiksyen, atau kontroversi. Ia adalah model berat terbuka yang disesuaikan untuk jawapan langsung.

Permintaan mengembalikan objek JSON yang mengandungi teks yang dijana. Jendela konteks menyokong 100,000 token digabungkan untuk prompt dan penyelesaian. Output terhad kepada 16,000 token setiap permintaan melainkan anda menentukan nilai 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 rasmi OpenAI dengan URL asas tersuai. Tetapkan api_key ke rentetan API anda. Konfigurasikan base_url ke titik ke pelayan Projek Heretic. Ini membolehkan anda menggunakan kaedah biasa seperti chat.completions.create() tanpa mengubah struktur kod sedia ada anda dengan ketara.

Pasang perpustakaan melalui pip. Lulus kelayakan anda terus ke inisialisasi klien. Perpustakaan mengendalikan serialisasi secara automatik. Pendekatan ini berfungsi untuk aliran kerja sinkron dan asinkron. Pastikan anda mengendalikan rangkaian rangkaian 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 berfungsi secara identikal dengan versi Python. Mulakan klien dengan kunci API dan URL asas yang betul. Anda boleh menghantar permintaan penyelesaian menggunakan tandatangan kaedah yang sama. Ini memastikan konsistensi merentas bahagian berbeza dalam tumpuan anda.

Tangani respons secara tak serentak. SDK menimbulkkan data jika anda menggunakan kaedah penstriman. Jika tidak, ia mengembalikan respons JSON penuh. Fleksibiliti ini menyokong kedua-dua pemprosesan berbatch dan antara muka masa nyata. Pastikan kunci API anda selamat dalam pembolehubah persekitaran.

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 aliran dengan menetapkan stream: true dalam permintaan anda. pelayan menghantar Acara Dihantar Pelayan (SSE). Setiap pecahan mengandungi kemas kini teks separa. Ini mengurangkan latensi yang dirasakan untuk pengguna akhir. Data penggunaan token muncul dalam pecahan akhir penstriman.

Proses setiap objek delta untuk mengumpul respons penuh. Berhenti mendengar apabila aliran ditutup atau berlaku ralat. Kaedah ini sesuai untuk antara muka sembang. Ia membolehkan pengguna melihat pemikiran terbentuk secara masa nyata. Beban adalah minimum berbanding 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)

Had, Ralat, dan Konteks

Hormati had kadar untuk mengelakkan gangguan perkhidmatan. Anda dibenarkan 300 permintaan setiap minit per kunci. Kebolehcanggihan dihadkan kepada 8 permintaan serentak. Badan permintaan tidak boleh melebihi 8 MB. Melebihi had ini akan mengembalikan kod status 429. Tunggu sebentar sebelum cuba semula.

Kegagalan pengesahan mengembalikan ralat 401. Ini berlaku jika kunci tidak sah atau luput. Ralat 402 menunjukkan kredit pra-dibayar tidak mencukupi. Kesilapan refund ditangani melalui Halaman Sokongan. Kredit tidak lupat. Model menolak kandungan yang melibatkan kanak-kanak. Semua kandungan lain yang sah diterima.