API Gyors kezdés & Integráció

Base URL és Hitelesítés

A Heretic Project egyetlen, hosztolt végpontot biztosít szöveggeneráláshoz. Használd https://api.hereticproject.com/v1 alap URL-ként. A hitelesítés egy, a Authorization fej. Hozza létre kulcsát a Google vagy e-mail bejelentkezéssel a műszerfalon. A rendszer fiókonként egy aktív kulcsot ad ki; egy új kulcs generálása azonnal érvényteleníti az előzőt.

Csak a felhasznált tokenekért fizet. A hibák és a visszautasítások nem terhelik az előre fizetett kreditet. Az új fiók $0,50 próbakreditet kap, amely hét napig érvényes. USDT (TRC20) vagy USDC (Base) segítségével tölthet fel $20 és $500 közötti összegeket.

A /v1/chat/completions végpont

Küldjön üzeneteket a standard chat completions végpontra. A modell azonosítója uncensored.Elfogad egy üzenetobjektumok listáját, amelyek szerepei például system, user, vagy assistant. A modell nem utasítja el a törvényes felnőtt, fikciós vagy vitatott témákat. Egy nyílt súlyú modell, amelyet közvetlen válaszokra hangoltak.

A kérések egy JSON objektumot adnak vissza, amely tartalmazza a generált szöveget. A kontextusablak 100,000 tokenre terjed ki a prompt és a kiegészítés együttesen. A kimenet kéréstenként 16,000 tokenre van korlátova, hacsak nem ad meg alacsonyabb max_tokens érték.

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"}]
  }'

Python SDK Integráció

Használja a hivatalos OpenAI Python könyvtárat egyéni alap URL-lel. Állítsa be a api_key az API szövegéhez. Konfigurálja a base_url mutasson a Heretic Project szerverére. Ez lehetővé teszi, hogy ismerős módszereket használjon, mint például chat.completions.create() meglévő kódstruktúra jelentős módosítása nélkül.

Telepítse a könyvtárat pip segítségével. Adja meg közvetlenül az ügyfelet inicializálásakor a hitelesítő adatait. A könyvtár automatikusan kezeli a szerializálást. Ez a megközelítés mind szinkron, mind aszinkron munkafolyamatok esetén működik. Győződjön meg arról, hogy az esetleges hálózati hibákat gracefully kezeli.

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)

Node SDK integráció

A Node.js SDK ugyanúgy működik, mint a Python verzió. Inicializálja a klienst az API-kulcsával és a helyes bázis URL-lel. Ugyanazokkal a metódus-aláírásokkal küldhet completion kéréseket. Ez konzisztenciát biztosít a stack különböző részei között.

Kezelje aszinkron módon a válaszokat. Az SDK streameli az adatokat, ha a streamelési módszert használja. Ellenkező esetben a teljes JSON választ adja vissza. Ez a rugalmasság támogatja mind a kötegelt feldolgozást, mind a valós idejű felületeket. Tartsa biztonságban az API-kulcsát környezetváltozókban.

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);

Streamelési válaszok (SSE)

Engedélyezze a streamelést úgy, hogy stream: true a kérésben. A szerver Server-Sent Events (SSE) eseményeket küld. Minden töredék részleges szövegfrissítéseket tartalmaz. Ez csökkenti az érzékelt késleltetést a végfelhasználók számára. A token-használati adatok a stream utolsó töredékében jelennek meg.

Feldolgozza minden delta objektumot a teljes válasz felhalmozásához. Álljon le a figyeléssel, amikor a stream lezárul vagy hiba történik. Ez a módszer ideális chat felületekhez. Lehetővé teszi a felhasználók számára, hogy valós időben lássák a gondolatok kialakulását. A túlterhelés minimális a teljes válaszokhoz képest.

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)

Korlátok, hibák és kontextus

Tartsd be a sebességkorlátokat a szolgáltatásmegszakítás elkerülése érdekében. Kulcsonként percenként 300 kérés engedélyezett. A párhuzamosság 8 egyidejű kérésben korlátozott. A kéréstörzs nem haladhatja meg a 8 MB-ot. A korlátok túllépése 429-es státuskódot eredményez. Várj egy kicsit az újrapróbálkozás előtt.

A hitelesítési kudarcok 401-es hibát adnak vissza. Ez akkor történik, ha a kulcs érvénytelen vagy lejárt. A 402-es hiba elégtelen előre fizetett kreditet jelez. A téves visszatérítéseket a Támogatási oldalon kezelik. A kredit sosem jár le. A modell megtagadja a kiskorúakkal kapcsolatos tartalmakat. Minden más törvényes tartalmat elfogad.