Dokumentasi API: Panduan Memulai Cepat

URL Dasar dan Autentikasi

API Heretic AI sepenuhnya kompatibel dengan OpenAI. Anda berinteraksi dengannya dengan mengarahkan klien Anda ke URL dasar kami: https://api.hereticai.cc/v1. Autentikasi bergantung pada satu kunci API per akun, yang dihasilkan secara instan saat pendaftaran melalui Google atau email. Teruskan kunci ini di Authorization header sebagai token Bearer. Pengidentifikasi modelnya hanyalah uncensored. Model tunggal ini menangani semua permintaan Anda tanpa kompleksitas pengalihan. Kesalahan seperti 401 menunjukkan kunci tidak valid, sedangkan 402 berarti Anda memerlukan lebih banyak kredit kripto prabayar.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Endpoint Chat Completions

Kirim permintaan teks menggunakan POST /v1/chat/completions endpoint. endpoint. API mengharapkan array pesan standar yang berisi riwayat percakapan atau prompt Anda. Ini mengembalikan teks yang dihasilkan di choices array. Ini adalah API utilitas murni: teks masuk, teks keluar. Anda hanya membayar untuk token yang dikonsumsi. Kredit prabayar tidak pernah kedaluwarsa, dan penolakan atau kesalahan tidak memakan token. Pendekatan ini menghilangkan kunci langganan dan tier gratis yang tidak dapat diprediksi.

Copyfrom openai import OpenAI

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

Respons Streaming (SSE)

Aktifkan streaming token secara real-time dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) untuk setiap token yang dihasilkan. Ini memungkinkan Anda menampilkan output secara progresif, yang sangat penting untuk aplikasi sensitif latensi. Statistik penggunaan token muncul di potongan terakhir aliran. Fitur ini berfungsi dengan lancar dengan SDK OpenAI standar yang menangani SSE secara otomatis. Ini memberikan umpan balik segera tanpa menunggu penyelesaian 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)

Pemanggilan Fungsi dan Alat

API mendukung pemanggilan fungsi dengan tools dan tool_choice parameter. Tentukan skema alat Anda dalam permintaan, dan model akan mengembalikan panggilan fungsi terstruktur saat sesuai. Ini memungkinkan alur kerja kompleks di mana LLM memutuskan tindakan selanjutnya. Anda dapat memaksa penggunaan alat tertentu atau membiarkan model memilih secara bebas. Kemampuan ini sangat penting untuk membangun aplikasi agentic yang berinteraksi dengan sistem eksternal atau basis data.

Mode JSON

Pastikan output deterministik dengan mengatur response_format ke {"type": "json_object"}. Model akan membatasi responsnya menjadi JSON valid, yang vital untuk parsing programatik. Ini mengurangi kebutuhan akan perbaikan regex pasca-pemrosesan. Ini menjamin bahwa output dapat langsung dikonsumsi oleh kode Anda. Ini sangat berguna untuk ekstraksi data terstruktur atau tugas generasi konfigurasi.

Parameter dan Batas

Kendalikan generasi dengan parameter standar seperti temperature, top_p, dan seed. Jendela konteks adalah 100.000 token untuk prompt ditambah penyelesaian. Output maksimum adalah 16.000 token per permintaan, atau 2.048 jika max_tokens tidak diatur. Batas laju adalah 300 permintaan per menit dan 8 permintaan simultan per kunci. Badan permintaan harus tetap di bawah 8 MB. Batas-batas ini memastikan penggunaan volume tinggi yang stabil untuk pengembang.

Node.js

Copyimport OpenAI from "openai";

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