Rychlý start API a integrace

Základní URL a ověření

Projekt Heretic poskytuje jeden hostovaný endpoint pro generování textu. Použijte https://api.hereticproject.com/v1 jako vaši základní URL. Autentizace spočívá v bearer tokenu předaném přes Authorization hlavička. Vytvořte si klíč přihlášením přes Google nebo e-mail v ovládacím panelu. Systém vydává jeden aktivní klíč na účet; vygenerování nového klíče okamžitě zneplatní předchozí.

Zaplatíte pouze za spotřebované tokeny. Chyby a odmítnutí nezatíží váš předplacený kredit. Nový účet získá $0,50 zkoušebního kreditu platného po dobu 7 dnů. Dobíjíte pomocí USDT (TRC20) nebo USDC (Base) v částkách mezi $20 a $500.

Endpoint /v1/chat/completions

Pošlete zprávy na standardní endpoint dokončování chatu. ID modelu je uncensored.Přijímá seznam objektů zpráv s rolí jako system, user, nebo assistant. Model neodmítá legální, fiktivní nebo kontroverzní témata. Jedná se o model s otevřenými váhami vyladěný pro přímé odpovědi.

Požadavky vrátí JSON objekt obsahující vygenerovaný text. Okno kontextu podporuje 100 000 tokenů celkem pro prompt a dokončení. Výstup je omezen na 16 000 tokenů na požadavek, pokud neurčíte nižší max_tokens hodnotou.

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

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python s vlastní základní URL. Nastavte api_key na váš API řetězec. Nakonfigurujte base_url aby ukazoval na server projektu Heretic. To vám umožní používat známé metody, jako chat.completions.create() bez výrazné změny stávající struktury kódu.

Nainstalujte knihovnu pomocí pip. Předejte své přihlašovací údaje přímo při inicializaci klienta. Knihovna automaticky řeší serializaci. Tento přístup funguje jak pro synchronní, tak pro asynchronní pracovní postupy. Ujistěte se, že zpracováváte možné síťové chyby elegantně.

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)

Integrace SDK pro Node

SDK pro Node.js funguje identicky jako verze pro Python. Inicializujte klienta svým API klíčem a správnou základní URL. Požadavky na completion můžete odesílat pomocí stejných podpisů metod. To zajišťuje konzistenci napříč různými částmi vašeho stacku.

Zpracujte odpovědi asynchronně. SDK streamuje data, pokud použijete metodu streamování. V ostatních případech vrátí plnou odpověď JSON. Tato flexibilita podporuje jak dávkové zpracování, tak rozhraní v reálném čase. Uchovávejte svůj klíč API v bezpečí v proměnných prostředí.

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

Streamované odpovědi (SSE)

Povolte streamování nastavením stream: true ve vaší žádosti. Server odesílá Server-Sent Events (SSE). Každý chunk obsahuje částečné aktualizace textu. To snižuje vnímanou latenci pro koncové uživatele. Data o využití tokenů se objevují v posledním chunku streamu.

Zpracovávejte každý objekt delta pro akumulaci celé odpovědi. Přestaňte poslouchat, když stream skončí nebo dojde k chybě. Tato metoda je ideální pro rozhraní chatů. Umožňuje uživatelům vidět myšlenky vznikat v reálném čase. Přídavné náklady jsou minimální ve srovnání s úplnými odpověďmi.

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)

Limity, chyby a kontext

Respektujte limity rychlosti, abyste předešli přerušení služby. Na klíč vám připadá 300 požadavků za minutu. Souběžnost je omezena na 8 souběžných požadavků. Tělo požadavku nesmí překročit 8 MB. Překročení těchto limitů vrátí stavový kód 429. Před opakováním počkejte chvíli.

Selhání ověření vrací chybu 401. Stane se tak, pokud je klíč neplatný nebo vypršel. Chyba 402 naznačuje nedostatek předplaceného kreditu. Chyby při omylu jsou řešeny přes stránku Podpory. Kredit nevyprší. Model odmítá obsah zahrnující nezletilé. Všechny jiné zákonné obsahy jsou přijímány.